Spec-Zone.ru › Laravel 10

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
защищённый булево $recordsModified

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

из Connection
защищённый булево $readOnWriteConnection

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

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

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

из Connection
защищённый булево $loggingQueries

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

из Connection
защищённый число с плавающей точкой $totalQueryDuration

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

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

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

из Connection
защищённый булево $pretending

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

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

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

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

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

из Connection
защищённый Connection $doctrineConnection

Экземпляр подключения Doctrine.

из Connection
защищённый массив<строка,строка> $doctrineTypeMappings

Сопоставления типов, которые должны быть зарегистрированы с новыми подключениями Doctrine.

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

Резолверы подключений.

из Connection

Методы

bool causedByConcurrencyError(Throwable $e)

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

from DetectsConcurrencyErrors
bool causedByLostConnection(Throwable $e)

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

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

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

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

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

from ManagesTransactions
void beginTransaction()

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

from ManagesTransactions
void createTransaction()

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

from ManagesTransactions
void createSavepoint()

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

from ManagesTransactions
void handleBeginTransactionException(Throwable $e)

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

from ManagesTransactions
void commit()

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

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

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

from ManagesTransactions
void rollBack(int|null $toLevel = null)

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

from ManagesTransactions
void performRollBack(int $toLevel)

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

from ManagesTransactions
void handleRollBackException(Throwable $e)

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

from ManagesTransactions
int transactionLevel()

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

from ManagesTransactions
void afterCommit(callable $callback)

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

from ManagesTransactions
int secondsUntil(DateTimeInterface|DateInterval|int $delay)

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

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

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

from InteractsWithTime
DateTimeInterface|int parseDateInterval(DateTimeInterface|DateInterval|int $delay)

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

from InteractsWithTime
int currentTime()

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

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

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

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

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

from Macroable
static bool hasMacro(string $name)

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

from Macroable
static void flushMacros()

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

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

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

from Macroable
mixed __call(string $method, array $parameters)

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

from 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)

Выполнить неподготовленный SQL-запрос через 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-запрос и залогировать его контекст выполнения.

from 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
bool isDoctrineAvailable()

Доступен ли Doctrine?

из Connection
bool usingNativeSchemaOperations()

Указывает, будут ли использоваться собственные операции изменения схемы при удалении, переименовании или изменении столбцов, даже если Doctrine DBAL установлен.

from Connection
Column getDoctrineColumn(string $table, string $column)

Получить экземпляр Doctrine Schema Column.

from Connection
AbstractSchemaManager getDoctrineSchemaManager()

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

from Connection
Connection getDoctrineConnection()

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

from Connection
void registerDoctrineType(Type|string $class, string $name, string $type)

Зарегистрировать пользовательский тип сопоставления Doctrine.

from Connection
PDO getPdo()

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

from Connection
PDO|Closure|null getRawPdo()

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

from Connection
PDO getReadPdo()

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

from Connection
PDO|Closure|null getRawReadPdo()

Получить текущий параметр подключения read 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
массив getQueryLog()

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

из Connection
массив getRawQueryLog()

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

из Connection
void flushQueryLog()

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

из Connection
void enableQueryLog()

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

из Connection
void disableQueryLog()

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

из Connection
bool logging()

Определить, ведётся ли протоколирование запросов.

из Connection
строка getDatabaseName()

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

из Connection
$this setDatabaseName(string $database)

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

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

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

из Connection
строка getTablePrefix()

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

из Connection
$this setTablePrefix(string $prefix)

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

из Connection
Grammar withTablePrefix(Grammar $grammar)

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

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

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

из Connection
static mixed getResolver(string $driver)

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

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

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

SqlServerDriver getDoctrineDriver()

Получить драйвер Doctrine DBAL.

Подробности

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
END_OF_DOCUMENT_MARKER

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.

Параметры

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

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 Grammar getDefaultQueryGrammar()

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

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

Grammar

void useDefaultSchemaGrammar()

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

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

void

protected Grammar|null getDefaultSchemaGrammar()

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

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

Grammar|null

void useDefaultPostProcessor()

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

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

void

protected Processor getDefaultPostProcessor()

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

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

Processor

Builder getSchemaBuilder()

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

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

Builder

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

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

Параметры

Closure|Builder|string $table
string|null $as

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

Builder

Builder query()

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

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

Builder

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

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

Параметры

string $query
array $bindings
bool $useReadPdo

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

mixed

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

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

Параметры

string $query
array $bindings
bool $useReadPdo

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

mixed

Исключения

MultipleColumnsSelectedException

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

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

Параметры

string $query
array $bindings

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

array

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

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

Параметры

string $query
array $bindings
bool $useReadPdo

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

array

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

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

Параметры

string $query
array $bindings
bool $useReadPdo

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

array

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

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

Параметры

string $query
array $bindings
bool $useReadPdo

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

Generator

protected PDOStatement prepared(PDOStatement $statement)

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

Параметры

PDOStatement $statement

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

PDOStatement

protected PDO getPdoForSelect(bool $useReadPdo = true)

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

Параметры

bool $useReadPdo

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

PDO

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

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

Параметры

string $query
array $bindings

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

bool

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

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

Параметры

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)

Выполнить неподготовленный (raw) запрос к соединению 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)

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

Параметры

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

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

mixed

Исключения

QueryException

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

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

Параметры

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

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

mixed

Исключения

QueryException

mixed|false reconnect()

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

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

mixed|false

Исключения

LostConnectionException

void reconnectIfMissingConnection()

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

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

void

void disconnect()

Отключиться от подключённого PDO соединения.

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

void

$this beforeStartingTransaction(Closure $callback)

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

Параметры

Closure $callback

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

$this

$this beforeExecuting(Closure $callback)

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

Параметры

Closure $callback

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

$this

void listen(Closure $callback)

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

Параметры

Closure $callback

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

void

protected array|null fireConnectionEvent(string $event)

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

Параметры

string $event

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

array|null

protected void event(mixed $event)

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

Параметры

mixed $event

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

void

Expression raw(mixed $value)

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

Параметры

mixed $value

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

Expression

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

Защитить значение для безопасного внедрения в SQL.

Параметры

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

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

string

protected string escapeString(string $value)

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

Параметры

string $value

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

string

protected string escapeBool(bool $value)

Защитить булево значение для безопасного внедрения в SQL.

Параметры

bool $value

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

string

protected string escapeBinary(string $value)

Защитить двоичное значение для безопасного внедрения в SQL.

Параметры

string $value

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

string

bool hasModifiedRecords()

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

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

bool

void recordsHaveBeenModified(bool $value = true)

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

Параметры

bool $value

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

void

$this setRecordModificationState(bool $value)

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

Параметры

bool $value

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

$this

void forgetRecordModificationState()

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

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

void

$this useWriteConnectionWhenReading(bool $value = true)

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

Параметры

bool $value

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

$this

bool isDoctrineAvailable()

Доступен ли Doctrine?

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

bool

bool usingNativeSchemaOperations()

Указывает, будут ли использоваться родные операции изменения схемы при удалении, переименовании или изменении столбцов, даже если Doctrine DBAL установлен.

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

bool

Column getDoctrineColumn(string $table, string $column)

Получить экземпляр Doctrine Schema Column.

Параметры

string $table
string $column

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

Column

AbstractSchemaManager getDoctrineSchemaManager()

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

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

AbstractSchemaManager

Connection getDoctrineConnection()

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

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

Connection

void registerDoctrineType(Type|string $class, string $name, string $type)

Зарегистрировать пользовательский тип отображения Doctrine.

Параметры

Type|string $class
string $name
string $type

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

void

Исключения

Exception
RuntimeException

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

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

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

Параметры

string $driver
Closure $callback

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

void

static mixed getResolver(string $driver)

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

Параметры

string $driver

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

mixed

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

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

Параметры

Filesystem $files
callable $processFactory

Исключения

RuntimeException

protected SqlServerDriver getDoctrineDriver()

Получить драйвер Doctrine DBAL.

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

SqlServerDriver

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

Spec-Zone.ru

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