Spec-Zone.ru › Laravel 11

SqlServerConnection

класс SqlServerConnection расширяет Connection (View source)

Трейты

DetectsConcurrencyErrors
DetectsLostConnections
ManagesTransactions
InteractsWithTime
Macroable

Свойства

статический защищённый массив $macros

Зарегистрированные строковые макросы.

из Macroable
защищённый PDO|Closure $pdo

Активное соединение PDO.

из Connection
защищённый PDO|Closure $readPdo

Активное соединение PDO, используемое для чтения.

из Connection
защищённая строка $database

Имя подключенной базы данных.

из Connection
защищённый строка|null $readWriteType

Тип подключения.

из Connection
защищённая строка $tablePrefix

Префикс таблицы для подключения.

из Connection
защищённый массив $config

Параметры конфигурации подключения к базе данных.

из Connection
защищённый вызываемый $reconnector

Инстанс повторного подключения для соединения.

из Connection
защищённый Grammar $queryGrammar

Реализация грамматики запросов.

из Connection
защищённый Grammar $schemaGrammar

Реализация грамматики схемы.

из Connection
защищённый Processor $postProcessor

Реализация постпроцессора запросов.

из Connection
защищённый Dispatcher $events

Инстанс диспетчера событий.

из Connection
защищённый целое число $fetchMode

Режим извлечения по умолчанию для соединения.

из Connection
защищённый целое число $transactions

Количество активных транзакций.

из Connection
защищённый DatabaseTransactionsManager $transactionsManager

Инстанс менеджера транзакций.

из Connection
защищённый boolean $recordsModified

Указывает, были ли внесены изменения в базу данных.

из Connection
защищённый boolean $readOnWriteConnection

Указывает, должно ли соединение использовать соединение PDO "write".

из Connection
защищённый массив $queryLog

Все запросы, выполненные к соединению.

из Connection
защищённый boolean $loggingQueries

Указывает, регистрируются ли запросы.

из Connection
защищённый float $totalQueryDuration

Продолжительность всех выполненных запросов в миллисекундах.

из Connection
защищённый массив $queryDurationHandlers

Все зарегистрированные обработчики продолжительности запросов.

из Connection
защищённый boolean $pretending

Указывает, находится ли соединение в режиме "сухого запуска".

из Connection
защищённый Closure[] $beforeStartingTransaction

Все обратные вызовы, которые должны быть вызваны перед началом транзакции.

из Connection
защищённый Closure[] $beforeExecutingCallbacks

Все обратные вызовы, которые должны быть вызваны перед выполнением запроса.

из Connection
статический защищённый Closure[] $resolvers

Решатели соединений.

из Connection

Методы

bool causedByConcurrencyError(Throwable $e)

Определить, было ли данное исключение вызвано ошибкой конкурентного доступа, например, тупиком или ошибкой сериализации.

из DetectsConcurrencyErrors
bool causedByLostConnection(Throwable $e)

Определить, было ли данное исключение вызвано потерей соединения.

из DetectsLostConnections
mixed transaction(Closure $callback, int $attempts = 1)

Выполнить замыкание в рамках транзакции.

void handleTransactionException(Throwable $e, int $currentAttempt, int $maxAttempts)

Обработать исключение, возникшее при выполнении транзакционного оператора.

из ManagesTransactions
void beginTransaction()

Начать новую базу данных транзакцию.

из ManagesTransactions
void createTransaction()

Создать транзакцию в базе данных.

из ManagesTransactions
void createSavepoint()

Создать точку сохранения в базе данных.

из ManagesTransactions
void handleBeginTransactionException(Throwable $e)

Обработать исключение при начале транзакции.

из ManagesTransactions
void commit()

Зафиксировать активную базу данных транзакцию.

из ManagesTransactions
void handleCommitTransactionException(Throwable $e, int $currentAttempt, int $maxAttempts)

Обработать исключение, возникшее при фиксации транзакции.

из ManagesTransactions
void rollBack(int|null $toLevel = null)

Отменить активную базу данных транзакцию.

из ManagesTransactions
void performRollBack(int $toLevel)

Выполнить откат в базе данных.

из ManagesTransactions
void handleRollBackException(Throwable $e)

Обработать исключение при откате.

из ManagesTransactions
int transactionLevel()

Получить количество активных транзакций.

из ManagesTransactions
void afterCommit(callable $callback)

Выполнить обратный вызов после фиксации транзакции.

из ManagesTransactions
int secondsUntil(DateTimeInterface|DateInterval|int $delay)

Получить количество секунд до заданной даты и времени.

из InteractsWithTime
int availableAt(DateTimeInterface|DateInterval|int $delay = 0)

Получить отметку времени «доступно в» в формате UNIX.

из InteractsWithTime
DateTimeInterface|int parseDateInterval(DateTimeInterface|DateInterval|int $delay)

Если заданное значение представляет собой интервал, преобразовать его в экземпляр DateTime.

из InteractsWithTime
int currentTime()

Получить текущее системное время в формате UNIX timestamp.

из InteractsWithTime
string runTimeForHumans(float $startTime, float $endTime = null)

Учитывая начальное время, отформатировать общее время выполнения для удобного восприятия человеком.

из InteractsWithTime
static void macro(string $name, object|callable $macro)

Зарегистрировать пользовательское макрос.

из Macroable
static void mixin(object $mixin, bool $replace = true)

Добавить в класс другой объект.

из Macroable
static bool hasMacro(string $name)

Проверяет, зарегистрировано ли макрос.

из Macroable
static void flushMacros()

Очистить существующие макросы.

из Macroable
static mixed __callStatic(string $method, array $parameters)

Динамически обрабатывать вызовы к классу.

из Macroable
mixed __call(string $method, array $parameters)

Динамически обрабатывать вызовы к классу.

из Macroable
void __construct(PDO|Closure $pdo, string $database = '', string $tablePrefix = '', array $config = [])

Создать новый экземпляр соединения с базой данных.

from Connection
void useDefaultQueryGrammar()

Установить синтаксис запроса на реализацию по умолчанию.

from Connection
Grammar getDefaultQueryGrammar()

Получить экземпляр синтаксиса запроса по умолчанию.

void useDefaultSchemaGrammar()

Установить синтаксис схемы на реализацию по умолчанию.

from Connection
Grammar|null getDefaultSchemaGrammar()

Получить экземпляр синтаксиса схемы по умолчанию.

void useDefaultPostProcessor()

Установить пост-процессор запроса на реализацию по умолчанию.

from Connection
Processor getDefaultPostProcessor()

Получить экземпляр пост-процессора по умолчанию.

Builder getSchemaBuilder()

Получить экземпляр строителя схемы для соединения.

Builder table(Closure|Builder|string $table, string|null $as = null)

Начать плавный запрос к таблице базы данных.

from Connection
Builder query()

Получить новый экземпляр построителя запросов.

from Connection
mixed selectOne(string $query, array $bindings = [], bool $useReadPdo = true)

Выполнить инструкцию select и вернуть один результат.

from Connection
mixed scalar(string $query, array $bindings = [], bool $useReadPdo = true)

Выполнить инструкцию select и вернуть первый столбец первой строки.

from Connection
array selectFromWriteConnection(string $query, array $bindings = [])

Выполнить инструкцию select в базе данных.

from Connection
array select(string $query, array $bindings = [], bool $useReadPdo = true)

Выполнить инструкцию select в базе данных.

from Connection
array selectResultSets(string $query, array $bindings = [], bool $useReadPdo = true)

Выполнить инструкцию select в базе данных и вернуть все наборы результатов.

from Connection
Generator cursor(string $query, array $bindings = [], bool $useReadPdo = true)

Выполнить инструкцию select в базе данных и вернуть генератор.

from Connection
PDOStatement prepared(PDOStatement $statement)

Настроить подготовленное утверждение PDO.

from Connection
PDO getPdoForSelect(bool $useReadPdo = true)

Получить соединение PDO для использования в запросе select.

from Connection
bool insert(string $query, array $bindings = [])

Выполнить инструкцию insert в базе данных.

from Connection
int update(string $query, array $bindings = [])

Выполнить инструкцию update в базе данных.

from Connection
int delete(string $query, array $bindings = [])

Выполнить инструкцию delete в базе данных.

from Connection
bool statement(string $query, array $bindings = [])

Выполнить SQL-инструкцию и вернуть булевый результат.

from Connection
int affectingStatement(string $query, array $bindings = [])

Выполнить SQL-инструкцию и получить количество затронутых строк.

from Connection
bool unprepared(string $query)

Выполнить неподготовленный необработанный запрос к соединению PDO.

from Connection
array pretend(Closure $callback)

Выполнить заданный обратный вызов в режиме «сухого запуска».

from Connection
mixed withoutPretending(Closure $callback)

Выполнить заданный обратный вызов без «притворства».

from Connection
array withFreshQueryLog(Closure $callback)

Выполнить заданный обратный вызов в режиме «сухого запуска».

from Connection
void bindValues(PDOStatement $statement, array $bindings)

Привязать значения к их параметрам в данном утверждении.

from Connection
array prepareBindings(array $bindings)

Подготовить привязки запроса для выполнения.

from Connection
mixed run(string $query, array $bindings, Closure $callback)

Выполнить SQL-запрос и записать контекст его выполнения.

из Connection
mixed runQueryCallback(string $query, array $bindings, Closure $callback)

Выполнить SQL-запрос.

из Connection
bool isUniqueConstraintError(Exception $exception)

Определить, вызвало ли исключение базы данных нарушение ограничения уникальности.

void logQuery(string $query, array $bindings, float|null $time = null)

Записать запрос в журнал запросов соединения.

из Connection
float getElapsedTime(int $start)

Получить время, прошедшее с заданной точки отсчета.

из Connection
void whenQueryingForLongerThan(DateTimeInterface|CarbonInterval|float|int $threshold, callable $handler)

Зарегистрировать обратный вызов, который будет вызван, если запрос к базе данных займет больше определенного времени.

из Connection
void allowQueryDurationHandlersToRunAgain()

Разрешить повторное выполнение всех обработчиков длительности запроса, даже если они уже были выполнены.

из Connection
float totalQueryDuration()

Получить общее время выполнения всех запросов в миллисекундах.

из Connection
void resetTotalQueryDuration()

Сбросить время выполнения всех запросов.

из Connection
mixed handleQueryException(QueryException $e, string $query, array $bindings, Closure $callback)

Обработать исключение запроса.

из Connection
mixed tryAgainIfCausedByLostConnection(QueryException $e, string $query, array $bindings, Closure $callback)

Обработать исключение запроса, возникшее во время выполнения запроса.

из Connection
mixed|false reconnect()

Подключиться к базе данных заново.

из Connection
void reconnectIfMissingConnection()

Подключиться к базе данных заново, если отсутствует подключение PDO.

из Connection
void disconnect()

Отключиться от базового подключения PDO.

из Connection
$this beforeStartingTransaction(Closure $callback)

Зарегистрировать обработчик, который будет выполнен непосредственно перед началом транзакции базы данных.

из Connection
$this beforeExecuting(Closure $callback)

Зарегистрировать обработчик, который будет выполнен непосредственно перед выполнением запроса к базе данных.

из Connection
void listen(Closure $callback)

Зарегистрировать слушателя запросов к базе данных в подключении.

из Connection
array|null fireConnectionEvent(string $event)

Сгенерировать событие для этого подключения.

из Connection
void event(mixed $event)

Сгенерировать событие, если возможно.

из Connection
Expression raw(mixed $value)

Получить новое выражение сырого запроса.

из Connection
string escape(string|float|int|bool|null $value, bool $binary = false)

Обработать значение для безопасной вставки в SQL-запрос.

из Connection
string escapeString(string $value)

Обработать строковое значение для безопасной вставки в SQL-запрос.

из Connection
string escapeBool(bool $value)

Обработать булево значение для безопасной вставки в SQL-запрос.

из Connection
string escapeBinary(string $value)

Обработать двоичное значение для безопасной вставки в SQL-запрос.

bool hasModifiedRecords()

Определить, были ли изменены записи в базе данных.

из Connection
void recordsHaveBeenModified(bool $value = true)

Указать, были ли изменены какие-либо записи.

из Connection
$this setRecordModificationState(bool $value)

Установить состояние изменения записей.

из Connection
void forgetRecordModificationState()

Сбросить состояние изменения записей.

из Connection
$this useWriteConnectionWhenReading(bool $value = true)

Указать, что подключение должно использовать запись PDO подключения для чтения.

из Connection
PDO getPdo()

Получить текущее соединение PDO.

from Connection
PDO|Closure|null getRawPdo()

Получить текущий параметр соединения PDO без выполнения логики повторного подключения.

from Connection
PDO getReadPdo()

Получить текущее соединение PDO, используемое для чтения.

from Connection
PDO|Closure|null getRawReadPdo()

Получить текущий параметр соединения PDO для чтения без выполнения логики повторного подключения.

from Connection
$this setPdo(PDO|Closure|null $pdo)

Установить соединение PDO.

from Connection
$this setReadPdo(PDO|Closure|null $pdo)

Установить соединение PDO, используемое для чтения.

from Connection
$this setReconnector(callable $reconnector)

Установить экземпляр повторного подключения для соединения.

from Connection
string|null getName()

Получить имя подключения к базе данных.

from Connection
string|null getNameWithReadWriteType()

Получить полное имя подключения к базе данных.

from Connection
mixed getConfig(string|null $option = null)

Получить параметр из параметров конфигурации.

from Connection
string getDriverName()

Получить имя драйвера PDO.

from Connection
Grammar getQueryGrammar()

Получить используемую грамматику запросов для подключения.

from Connection
$this setQueryGrammar(Grammar $grammar)

Установить используемую грамматику запросов для подключения.

from Connection
Grammar getSchemaGrammar()

Получить используемую грамматику схемы для подключения.

from Connection
$this setSchemaGrammar(Grammar $grammar)

Установить используемую грамматику схемы для подключения.

from Connection
Processor getPostProcessor()

Получить используемого обработчика запросов после выполнения для подключения.

from Connection
$this setPostProcessor(Processor $processor)

Установить используемого обработчика запросов после выполнения для подключения.

from Connection
Dispatcher getEventDispatcher()

Получить используемого диспетчера событий для подключения.

from Connection
$this setEventDispatcher(Dispatcher $events)

Установить экземпляр диспетчера событий для соединения.

from Connection
void unsetEventDispatcher()

Удалить диспетчера событий для этого подключения.

from Connection
$this setTransactionManager(DatabaseTransactionsManager $manager)

Установить экземпляр менеджера транзакций для соединения.

from Connection
void unsetTransactionManager()

Удалить менеджер транзакций для этого подключения.

from Connection
bool pretending()

Определить, находится ли соединение в режиме "сухого запуска".

from Connection
array getQueryLog()

Получить журнал запросов соединения.

from Connection
array getRawQueryLog()

Получить журнал запросов соединения со встроенными значениями связей.

from Connection
void flushQueryLog()

Очистить журнал запросов.

from Connection
void enableQueryLog()

Включить журнал запросов для подключения.

from Connection
void disableQueryLog()

Выключить журнал запросов для подключения.

from Connection
bool logging()

Определить, ведем ли мы протокол запросов.

from Connection
string getDatabaseName()

Получить имя подключенной базы данных.

из Connection
$this setDatabaseName(string $database)

Установить имя подключенной базы данных.

из Connection
$this setReadWriteType(string|null $readWriteType)

Установить тип чтения/записи соединения.

из Connection
string getTablePrefix()

Получить префикс таблицы для соединения.

из Connection
$this setTablePrefix(string $prefix)

Установить используемый префикс таблицы для соединения.

из Connection
Grammar withTablePrefix(Grammar $grammar)

Установить префикс таблицы и вернуть синтаксический анализатор.

из Connection
string getServerVersion()

Получить версию сервера для соединения.

из Connection
static void resolverFor(string $driver, Closure $callback)

Зарегистрировать разрешитель соединений.

из Connection
static mixed getResolver(string $driver)

Получить разрешитель соединений для указанного драйвера.

из Connection
getSchemaState(Filesystem|null $files = null, callable|null $processFactory = null)

Получить состояние схемы для соединения.

Подробности

protected bool causedByConcurrencyError(Throwable $e)

Определить, была ли данная ошибка вызвана ошибкой конкурентного выполнения, такой как тупик или ошибка сериализации.

Параметры

Throwable $e

Возвращаемое значение

bool

protected bool causedByLostConnection(Throwable $e)

Определить, была ли данная ошибка вызвана потерей соединения.

Параметры

Throwable $e

Возвращаемое значение

bool

mixed transaction(Closure $callback, int $attempts = 1)

Выполнить замыкание в рамках транзакции.

Параметры

Closure $callback
int $attempts

Возвращаемое значение

mixed

Исключения

Throwable

protected void handleTransactionException(Throwable $e, int $currentAttempt, int $maxAttempts)

Обработать исключение, возникшее при выполнении транзакционного оператора.

Параметры

Throwable $e
int $currentAttempt
int $maxAttempts

Возвращаемое значение

void

Исключения

Throwable

void beginTransaction()

Начать новую базу данных транзакцию.

Возвращаемое значение

void

Исключения

Throwable

protected void createTransaction()

Создать транзакцию в базе данных.

Возвращаемое значение

void

Исключения

Throwable

protected void createSavepoint()

Создать точку сохранения в базе данных.

Возвращаемое значение

void

Исключения

Throwable

protected void handleBeginTransactionException(Throwable $e)

Обработать исключение при начале транзакции.

Параметры

Throwable $e

Возвращаемое значение

void

Исключения

Throwable

void commit()

Зафиксировать активную базу данных транзакцию.

Возвращаемое значение

void

Исключения

Throwable

protected void handleCommitTransactionException(Throwable $e, int $currentAttempt, int $maxAttempts)

Обработать исключение, возникшее при фиксации транзакции.

Параметры

Throwable $e
int $currentAttempt
int $maxAttempts

Возвращаемое значение

void

Исключения

Throwable

void rollBack(int|null $toLevel = null)

Отменить активную базу данных транзакцию.

Параметры

int|null $toLevel

Возвращаемое значение

void

Исключения

Throwable

protected void performRollBack(int $toLevel)

Выполнить откат в базе данных.

Параметры

int $toLevel

Возвращаемое значение

void

Исключения

Throwable

protected void handleRollBackException(Throwable $e)

Обработать исключение при откате.

Параметры

Throwable $e

Возвращаемое значение

void

Исключения

Throwable

int transactionLevel()

Получить количество активных транзакций.

Возвращаемое значение

int

void afterCommit(callable $callback)

Выполнить обратный вызов после завершения транзакции.

Параметры

callable $callback

Возвращаемое значение

void

Исключения

RuntimeException

protected int secondsUntil(DateTimeInterface|DateInterval|int $delay)

Получить количество секунд до указанной даты.

Параметры

DateTimeInterface|DateInterval|int $delay

Возвращаемое значение

int

protected int availableAt(DateTimeInterface|DateInterval|int $delay = 0)

Получить отметку времени «доступно в» в формате UNIX timestamp.

Параметры

DateTimeInterface|DateInterval|int $delay

Возвращаемое значение

int

protected DateTimeInterface|int parseDateInterval(DateTimeInterface|DateInterval|int $delay)

Если заданное значение является интервалом, преобразовать его в экземпляр DateTime.

Параметры

DateTimeInterface|DateInterval|int $delay

Возвращаемое значение

DateTimeInterface|int

protected int currentTime()

Получить текущее системное время в формате UNIX timestamp.

Возвращаемое значение

int

protected string runTimeForHumans(float $startTime, float $endTime = null)

Вывести продолжительность выполнения в удобочитаемом формате.

Параметры

float $startTime
float $endTime

Возвращаемое значение

string

static void macro(string $name, object|callable $macro)

Зарегистрировать пользовательскую макрокоманду.

Параметры

string $name
object|callable $macro

Возвращаемое значение

void

static void mixin(object $mixin, bool $replace = true)

Добавить другой объект в класс.

Параметры

object $mixin
bool $replace

Возвращаемое значение

void

Исключения

ReflectionException

static bool hasMacro(string $name)

Проверяет, зарегистрирована ли макрокоманда.

Параметры

string $name

Возвращаемое значение

bool

static void flushMacros()

Очистить существующие макрокоманды.

Возвращаемое значение

void

static mixed __callStatic(string $method, array $parameters)

Динамически обрабатывает вызовы класса.

Параметры

string $method
array $parameters

Возвращаемое значение

mixed

Исключения

BadMethodCallException

mixed __call(string $method, array $parameters)

Динамически обрабатывает вызовы класса.

Параметры

string $method
array $parameters

Возвращаемое значение

mixed

Исключения

BadMethodCallException

void __construct(PDO|Closure $pdo, string $database = '', string $tablePrefix = '', array $config = [])

Создать новый экземпляр подключения к базе данных.

Параметры

PDO|Closure $pdo
string $database
string $tablePrefix
array $config

Возвращаемое значение

void

void useDefaultQueryGrammar()

Установить синтаксический анализатор запросов по умолчанию.

Возвращаемое значение

void

protected Грамматика getDefaultQueryGrammar()

Получить экземпляр грамматики запросов по умолчанию.

Значение возврата

Грамматика

void useDefaultSchemaGrammar()

Установить грамматику схемы на стандартную реализацию.

Значение возврата

void

protected Грамматика|null getDefaultSchemaGrammar()

Получить экземпляр грамматики схемы по умолчанию.

Значение возврата

Грамматика|null

void useDefaultPostProcessor()

Установить обработчик запросов на стандартную реализацию.

Значение возврата

void

protected Обработчик getDefaultPostProcessor()

Получить экземпляр обработчика по умолчанию.

Значение возврата

Обработчик

Построитель getSchemaBuilder()

Получить экземпляр построителя схемы для подключения.

Значение возврата

Построитель

Построитель table(Закрытая функция|Построитель|string $table, string|null $as = null)

Начать флегматичный запрос к таблице базы данных.

Параметры

Закрытая функция|Построитель|string $table
string|null $as

Значение возврата

Построитель

Построитель query()

Получить новый экземпляр построителя запросов.

Значение возврата

Построитель

смешанный selectOne(string $query, array $bindings = [], bool $useReadPdo = true)

Выполнить запрос select и вернуть единственный результат.

Параметры

string $query
array $bindings
bool $useReadPdo

Значение возврата

смешанный

смешанный scalar(string $query, array $bindings = [], bool $useReadPdo = true)

Выполнить запрос select и вернуть первую колонку первой строки.

Параметры

string $query
array $bindings
bool $useReadPdo

Значение возврата

смешанный

Исключения

MultipleColumnsSelectedException

массив selectFromWriteConnection(string $query, array $bindings = [])

Выполнить запрос select в базе данных.

Параметры

string $query
array $bindings

Значение возврата

массив

массив select(string $query, array $bindings = [], bool $useReadPdo = true)

Выполнить запрос select в базе данных.

Параметры

string $query
array $bindings
bool $useReadPdo

Значение возврата

массив

массив selectResultSets(string $query, array $bindings = [], bool $useReadPdo = true)

Выполнить запрос select в базе данных и вернуть все наборы результатов.

Параметры

string $query
array $bindings
bool $useReadPdo

Значение возврата

массив

Генератор cursor(string $query, array $bindings = [], bool $useReadPdo = true)

Выполнить запрос select в базе данных и вернуть генератор.

Параметры

string $query
array $bindings
bool $useReadPdo

Значение возврата

Генератор

protected PDOStatement prepared(PDOStatement $statement)

Настроить оператор PDO prepared.

Параметры

PDOStatement $statement

Значение возврата

PDOStatement

protected PDO getPdoForSelect(bool $useReadPdo = true)

Получить подключение PDO для запроса select.

Параметры

bool $useReadPdo

Значение возврата

PDO

bool insert(string $query, array $bindings = [])

Выполнить запрос insert в базе данных.

Параметры

string $query
array $bindings

Значение возврата

bool

int update(string $query, array $bindings = [])

Выполнить запрос update в базе данных.

Параметры

string $query
array $bindings

Значение возврата

int

int delete(string $query, array $bindings = [])

Выполнить операцию удаления в базе данных.

Параметры

string $query
array $bindings

Возвращаемое значение

int

bool statement(string $query, array $bindings = [])

Выполнить SQL-запрос и вернуть логическое значение результата.

Параметры

string $query
array $bindings

Возвращаемое значение

bool

int affectingStatement(string $query, array $bindings = [])

Выполнить SQL-запрос и получить количество затронутых строк.

Параметры

string $query
array $bindings

Возвращаемое значение

int

bool unprepared(string $query)

Выполнить неподготовленный, сырой запрос к соединению PDO.

Параметры

string $query

Возвращаемое значение

bool

array pretend(Closure $callback)

Выполнить заданный обратный вызов в режиме "сухого запуска".

Параметры

Closure $callback

Возвращаемое значение

array

mixed withoutPretending(Closure $callback)

Выполнить заданный обратный вызов без "имитации".

Параметры

Closure $callback

Возвращаемое значение

mixed

protected array withFreshQueryLog(Closure $callback)

Выполнить заданный обратный вызов в режиме "сухого запуска".

Параметры

Closure $callback

Возвращаемое значение

array

void bindValues(PDOStatement $statement, array $bindings)

Связать значения с параметрами в данном операторе.

Параметры

PDOStatement $statement
array $bindings

Возвращаемое значение

void

array prepareBindings(array $bindings)

Подготовить связывания запроса для выполнения.

Параметры

array $bindings

Возвращаемое значение

array

protected mixed run(string $query, array $bindings, Closure $callback)

Выполнить SQL-запрос и записать контекст его выполнения.

Параметры

string $query
array $bindings
Closure $callback

Возвращаемое значение

mixed

Исключения

QueryException

protected mixed runQueryCallback(string $query, array $bindings, Closure $callback)

Выполнить SQL-запрос.

Параметры

string $query
array $bindings
Closure $callback

Возвращаемое значение

mixed

Исключения

QueryException

protected bool isUniqueConstraintError(Exception $exception)

Определить, вызвано ли данное исключение базы данных нарушением уникальности.

Параметры

Exception $exception

Возвращаемое значение

bool

void logQuery(string $query, array $bindings, float|null $time = null)

Записать запрос в журнал запросов соединения.

Параметры

string $query
array $bindings
float|null $time

Возвращаемое значение

void

protected float getElapsedTime(int $start)

Получить время, прошедшее с заданной начальной точки.

Параметры

int $start

Возвращаемое значение

float

void whenQueryingForLongerThan(DateTimeInterface|CarbonInterval|float|int $threshold, callable $handler)

Зарегистрировать обратный вызов, который будет вызван, когда запрос к соединению займет более заданного времени.

Параметры

DateTimeInterface|CarbonInterval|float|int $threshold
callable $handler

Возвращаемое значение

void

void allowQueryDurationHandlersToRunAgain()

Разрешить повторное выполнение всех обработчиков длительности запросов, даже если они уже были выполнены.

Возвращаемое значение

void

float totalQueryDuration()

Получить продолжительность всех выполненных запросов в миллисекундах.

Возвращаемое значение

float

void resetTotalQueryDuration()

Сбросить продолжительность всех выполненных запросов.

Возвращаемое значение

void

protected mixed handleQueryException(QueryException $e, string $query, array $bindings, Closure $callback)

Обработка исключения запроса.

Parameters

QueryException $e
string $query
array $bindings
Closure $callback

Return Value

mixed

Exceptions

QueryException

protected mixed tryAgainIfCausedByLostConnection(QueryException $e, string $query, array $bindings, Closure $callback)

Обработка исключения запроса, произошедшего во время выполнения запроса.

Parameters

QueryException $e
string $query
array $bindings
Closure $callback

Return Value

mixed

Exceptions

QueryException

mixed|false reconnect()

Подключение к базе данных.

Return Value

mixed|false

Exceptions

LostConnectionException

void reconnectIfMissingConnection()

Восстановление подключения к базе данных, если соединение PDO отсутствует.

Return Value

void

void disconnect()

Отключение от базового соединения PDO.

Return Value

void

$this beforeStartingTransaction(Closure $callback)

Регистрация обработчика, который выполняется непосредственно перед началом транзакции базы данных.

Parameters

Closure $callback

Return Value

$this

$this beforeExecuting(Closure $callback)

Регистрация обработчика, который выполняется непосредственно перед выполнением запроса к базе данных.

Parameters

Closure $callback

Return Value

$this

void listen(Closure $callback)

Регистрация прослушивателя запросов к базе данных с подключением.

Parameters

Closure $callback

Return Value

void

protected array|null fireConnectionEvent(string $event)

Вызов события для этого подключения.

Parameters

string $event

Return Value

array|null

protected void event(mixed $event)

Вызвать заданное событие, если это возможно.

Parameters

mixed $event

Return Value

void

Expression raw(mixed $value)

Получение нового выражения сырого запроса.

Parameters

mixed $value

Return Value

Expression

string escape(string|float|int|bool|null $value, bool $binary = false)

Экранирование значения для безопасной вставки в SQL.

Parameters

string|float|int|bool|null $value
bool $binary

Return Value

string

protected string escapeString(string $value)

Экранирование строкового значения для безопасной вставки в SQL.

Parameters

string $value

Return Value

string

protected string escapeBool(bool $value)

Экранирование булевого значения для безопасной вставки в SQL.

Parameters

bool $value

Return Value

string

protected string escapeBinary(string $value)

Экранирование двоичного значения для безопасной вставки в SQL.

Parameters

string $value

Return Value

string

bool hasModifiedRecords()

Определение, изменил ли объект базы данных какие-либо записи базы данных.

Return Value

bool

void recordsHaveBeenModified(bool $value = true)

Указание, были ли изменены какие-либо записи.

Parameters

bool $value

Return Value

void

$this setRecordModificationState(bool $value)

Установить состояние изменения записи.

Parameters

bool $value

Return Value

$this

void forgetRecordModificationState()

Сбросить состояние изменения записи.

Return Value

void

$this useWriteConnectionWhenReading(bool $value = true)

Укажите, что подключение должно использовать запись PDO-подключения для чтения.

Параметры

bool $value

Значение, возвращаемое функцией

$this

PDO getPdo()

Получить текущее PDO-подключение.

Значение, возвращаемое функцией

PDO

PDO|Closure|null getRawPdo()

Получить текущий параметр PDO-подключения без выполнения какой-либо логики повторного подключения.

Значение, возвращаемое функцией

PDO|Closure|null

PDO getReadPdo()

Получить текущее PDO-подключение, используемое для чтения.

Значение, возвращаемое функцией

PDO

PDO|Closure|null getRawReadPdo()

Получить текущий параметр PDO-подключения для чтения без выполнения какой-либо логики повторного подключения.

Значение, возвращаемое функцией

PDO|Closure|null

$this setPdo(PDO|Closure|null $pdo)

Установить PDO-подключение.

Параметры

PDO|Closure|null $pdo

Значение, возвращаемое функцией

$this

$this setReadPdo(PDO|Closure|null $pdo)

Установить PDO-подключение, используемое для чтения.

Параметры

PDO|Closure|null $pdo

Значение, возвращаемое функцией

$this

$this setReconnector(callable $reconnector)

Установить экземпляр повторного подключения к базе данных.

Параметры

callable $reconnector

Значение, возвращаемое функцией

$this

string|null getName()

Получить имя подключения к базе данных.

Значение, возвращаемое функцией

string|null

string|null getNameWithReadWriteType()

Получить полное имя подключения к базе данных.

Значение, возвращаемое функцией

string|null

mixed getConfig(string|null $option = null)

Получить параметр из конфигурации.

Параметры

string|null $option

Значение, возвращаемое функцией

mixed

string getDriverName()

Получить имя драйвера PDO.

Значение, возвращаемое функцией

string

Grammar getQueryGrammar()

Получить синтаксический анализатор запросов, используемый подключением.

Значение, возвращаемое функцией

Grammar

$this setQueryGrammar(Grammar $grammar)

Установить синтаксический анализатор запросов, используемый подключением.

Параметры

Grammar $grammar

Значение, возвращаемое функцией

$this

Grammar getSchemaGrammar()

Получить синтаксический анализатор схемы, используемый подключением.

Значение, возвращаемое функцией

Grammar

$this setSchemaGrammar(Grammar $grammar)

Установить синтаксический анализатор схемы, используемый подключением.

Параметры

Grammar $grammar

Значение, возвращаемое функцией

$this

Processor getPostProcessor()

Получить обработчик запросов, используемый подключением.

Значение, возвращаемое функцией

Processor

$this setPostProcessor(Processor $processor)

Установить обработчик запросов, используемый подключением.

Параметры

Processor $processor

Значение, возвращаемое функцией

$this

Dispatcher getEventDispatcher()

Получить диспетчер событий, используемый подключением.

Значение, возвращаемое функцией

Dispatcher

$this setEventDispatcher(Dispatcher $events)

Установить экземпляр диспетчера событий для подключения.

Параметры

Dispatcher $events

Значение, возвращаемое функцией

$this

void unsetEventDispatcher()

Отключить диспетчер событий для этого подключения.

Возвращаемое значение

void

$this setTransactionManager(DatabaseTransactionsManager $manager)

Установить экземпляр менеджера транзакций для подключения.

Параметры

DatabaseTransactionsManager $manager

Возвращаемое значение

$this

void unsetTransactionManager()

Отключить менеджер транзакций для этого подключения.

Возвращаемое значение

void

bool pretending()

Определить, находится ли подключение в режиме «сухого запуска».

Возвращаемое значение

bool

array getQueryLog()

Получить журнал запросов подключения.

Возвращаемое значение

array

array getRawQueryLog()

Получить журнал запросов подключения с вложенными значениями связей.

Возвращаемое значение

array

void flushQueryLog()

Очистить журнал запросов.

Возвращаемое значение

void

void enableQueryLog()

Включить журнал запросов для подключения.

Возвращаемое значение

void

void disableQueryLog()

Отключить журнал запросов для подключения.

Возвращаемое значение

void

bool logging()

Определить, ведется ли регистрация запросов.

Возвращаемое значение

bool

string getDatabaseName()

Получить имя подключенной базы данных.

Возвращаемое значение

string

$this setDatabaseName(string $database)

Установить имя подключенной базы данных.

Параметры

string $database

Возвращаемое значение

$this

$this setReadWriteType(string|null $readWriteType)

Установить тип чтения/записи подключения.

Параметры

string|null $readWriteType

Возвращаемое значение

$this

string getTablePrefix()

Получить префикс таблицы для подключения.

Возвращаемое значение

string

$this setTablePrefix(string $prefix)

Установить префикс таблицы, используемый подключением.

Параметры

string $prefix

Возвращаемое значение

$this

Grammar withTablePrefix(Grammar $grammar)

Установить префикс таблицы и вернуть синтаксический анализатор.

Параметры

Grammar $grammar

Возвращаемое значение

Grammar

string getServerVersion()

Получить версию сервера для подключения.

Возвращаемое значение

string

static void resolverFor(string $driver, Closure $callback)

Зарегистрировать разрешитель подключения.

Параметры

string $driver
Closure $callback

Возвращаемое значение

void

static mixed getResolver(string $driver)

Получить разрешитель подключения для указанного драйвера.

Параметры

string $driver

Возвращаемое значение

mixed

getSchemaState(Filesystem|null $files = null, callable|null $processFactory = null)

Получить состояние схемы для подключения.

Параметры

Filesystem|null $files
callable|null $processFactory

Исключения

RuntimeException

© Taylor Otwell
Licensed under the MIT License.
Laravel is a trademark of Taylor Otwell.
https://laravel.com/api/11.x/Illuminate/Database/SqlServerConnection.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API