Spec-Zone.ru › Laravel 11

Подключение

класс Подключение реализует Интерфейс подключения (Просмотреть исходный код)

Трейты

Обнаружение конфликтов одновременного доступа
Обнаружение потерянных подключений
Управление транзакциями
Взаимодействие со временем
Макроспособный

Свойства

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

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

из Макроспособный
защищенный PDO|Closure $pdo

Активное подключение PDO.

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

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

защищенный строка $database

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

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

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

защищенный строка $tablePrefix

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

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

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

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

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

защищенный Грамматика запросов $queryGrammar

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

защищенный Грамматика схемы $schemaGrammar

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

защищенный Обработчик $postProcessor

Реализация пост-обработчика запросов.

защищенный Диспечер событий $events

Экземпляр диспетчера событий.

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

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

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

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

защищенный Менеджер транзакций $transactionsManager

Экземпляр менеджера транзакций.

защищенный логическое значение $recordsModified

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

защищенный логическое значение $readOnWriteConnection

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

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

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

защищенный логическое значение $loggingQueries

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

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

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

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

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

защищенный логическое значение $pretending

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

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

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

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

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

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

Решатели подключения.

Методы

bool causedByConcurrencyError(Throwable $e)

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

из DetectsConcurrencyErrors
bool causedByLostConnection(Throwable $e)

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

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

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

из ManagesTransactions
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 = [])

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

void useDefaultQueryGrammar()

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

Grammar getDefaultQueryGrammar()

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

void useDefaultSchemaGrammar()

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

Grammar|null getDefaultSchemaGrammar()

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

void useDefaultPostProcessor()

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

Processor getDefaultPostProcessor()

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

Builder getSchemaBuilder()

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

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

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

Builder query()

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

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

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

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

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

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

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

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

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

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

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

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

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

PDOStatement prepared(PDOStatement $statement)

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

PDO getPdoForSelect(bool $useReadPdo = true)

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

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

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

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

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

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

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

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

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

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

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

bool unprepared(string $query)

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

array pretend(Closure $callback)

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

mixed withoutPretending(Closure $callback)

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

array withFreshQueryLog(Closure $callback)

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

void bindValues(PDOStatement $statement, array $bindings)

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

array prepareBindings(array $bindings)

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

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

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

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

Выполнить SQL-инструкцию.

bool isUniqueConstraintError(Exception $exception)

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

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

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

float getElapsedTime(int $start)

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

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

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

void allowQueryDurationHandlersToRunAgain()

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

float totalQueryDuration()

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

void resetTotalQueryDuration()

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

mixed обработатьИсключениеЗапроса(QueryException $e, string $query, array $bindings, Closure $callback)

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

mixed повторитьПопыткуЕслиВызванаПотерейПодключения(QueryException $e, string $query, array $bindings, Closure $callback)

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

mixed|false подключитьсяЗаново()

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

void подключитьсяЗановоЕслиПодключениеОтсутствует()

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

void отключиться()

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

$this передНачаломТранзакции(Closure $callback)

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

$this передВыполнением(Closure $callback)

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

void прослушивать(Closure $callback)

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

array|null сработатьСобытиеПодключения(string $event)

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

void событие(mixed $event)

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

Expression сырой(mixed $value)

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

string экранировать(string|float|int|bool|null $value, bool $binary = false)

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

string экранироватьСтроку(string $value)

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

string экранироватьБулево(bool $value)

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

string экранироватьБинарное(string $value)

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

bool имеетИзмененныеЗаписи()

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

void записиБылиИзменены(bool $value = true)

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

$this установитьСостояниеИзмененияЗаписи(bool $value)

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

void забытьСостояниеИзмененияЗаписи()

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

$this использоватьПодключениеДляЗаписиПриЧтении(bool $value = true)

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

PDO получитьPDO()

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

PDO|Closure|null получитьНеобработанноеPDO()

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

PDO получитьPDOДляЧтения()

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

PDO|Closure|null получитьНеобработанноеPDOДляЧтения()

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

$this установитьPDO(PDO|Closure|null $pdo)

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

$this установитьPDOДляЧтения(PDO|Closure|null $pdo)

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

$this установитьПовторноеПодключение(callable $reconnector)

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

string|null получитьИмя()

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

string|null получитьИмяСТипомЧтенияЗаписи()

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

mixed получитьКонфигурацию(string|null $option = null)

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

string получитьИмяДрайвера()

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

Grammar получитьГрамматикуЗапроса()

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

$this установитьГрамматикуЗапроса(Grammar $grammar)

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

Grammar получитьГрамматикуСхемы()

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

$this установитьГрамматикуСхемы(Grammar $grammar)

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

Processor получитьОбработчикПослеЗапроса()

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

$this установитьОбработчикПослеЗапроса(Processor $processor)

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

Dispatcher получитьДиспетчерСобытий()

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

$this установитьДиспетчерСобытий(Dispatcher $events)

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

void удалитьДиспетчерСобытий()

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

$this установитьМенеджераТранзакций(DatabaseTransactionsManager $manager)

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

void удалитьМенеджераТранзакций()

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

bool имитировать()

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

array получитьЛогЗапросов()

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

array получитьНеобработанныйЛогЗапросов()

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

void очиститьЛогЗапросов()

Очистить лог запросов.

void включитьЛогЗапросов()

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

void выключитьЛогЗапросов()

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

bool журналирование()

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

string получитьИмяБД()

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

$this установитьИмяБД(string $database)

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

$this установитьТипЧтенияЗаписи(string|null $readWriteType)

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

string получитьПрефиксТаблицы()

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

$this установитьПрефиксТаблицы(string $prefix)

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

Grammar сПрефиксомТаблицы(Grammar $grammar)

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

string получитьВерсиюСервера()

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

static void резолверДля(string $driver, Closure $callback)

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

static mixed получитьРезолвер(string $driver)

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

Подробности

protected bool причинаКонфликтаПотоков(Throwable $e)

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

Parameters

Throwable $e

Return Value

bool

protected bool причинаПотериПодключения(Throwable $e)

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

Parameters

Throwable $e

Return Value

bool

mixed транзакция(Closure $callback, int $attempts = 1)

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

Parameters

Closure $callback
int $attempts

Return Value

mixed

Exceptions

Throwable

protected void обработкаИсключенияТранзакции(Throwable $e, int $currentAttempt, int $maxAttempts)

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

Parameters

Throwable $e
int $currentAttempt
int $maxAttempts

Return Value

void

Exceptions

Throwable

void началоТранзакции()

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

Return Value

void

Exceptions

Throwable

protected void создатьТранзакцию()

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

Return Value

void

Exceptions

Throwable

protected void создатьТочкуСохранения()

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

Return Value

void

Exceptions

Throwable

protected void обработкаИсключенияПриНачалеТранзакции(Throwable $e)

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

Parameters

Throwable $e

Return Value

void

Exceptions

Throwable

void зафиксировать()

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

Return Value

void

Exceptions

Throwable
END_OF_DOCUMENT_MARKER

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)

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

Параметры

DateTimeInterface|DateInterval|int $delay

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

int

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

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

Параметры

DateTimeInterface|DateInterval|int $delay

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

DateTimeInterface|int

protected int currentTime()

Получить текущее системное время в виде метки времени Unix.

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

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

смешанный тип __call(string $method, array $parameters)

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

Параметры

строка $method
массив $parameters

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

смешанный тип

Исключения

BadMethodCallException

пустое значение __construct(PDO|Closure $pdo, string $database = '', string $tablePrefix = '', array $config = [])

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

Параметры

PDO|Closure $pdo
строка $database
строка $tablePrefix
массив $config

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

пустое значение

пустое значение useDefaultQueryGrammar()

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

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

пустое значение

защищённый Grammar getDefaultQueryGrammar()

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

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

Grammar

пустое значение useDefaultSchemaGrammar()

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

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

пустое значение

защищённый Grammar|null getDefaultSchemaGrammar()

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

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

Grammar|null

пустое значение useDefaultPostProcessor()

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

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

пустое значение

защищённый Processor getDefaultPostProcessor()

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

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

Processor

Builder getSchemaBuilder()

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

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

Builder

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

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

Параметры

Closure|Builder|строка $table
строка|null $as

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

Builder

Builder query()

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

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

Builder

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

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

Параметры

строка $query
массив $bindings
логическое значение $useReadPdo

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

смешанный тип

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

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

Параметры

строка $query
массив $bindings
логическое значение $useReadPdo

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

смешанный тип

Исключения

MultipleColumnsSelectedException

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

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

Параметры

строка $query
массив $bindings

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

массив

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

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

Параметры

строка $query
массив $bindings
логическое значение $useReadPdo

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

массив

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

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

Параметры

строка $query
массив $bindings
логическое значение $useReadPdo

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

массив

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

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

Параметры

строка $query
массив $bindings
логическое значение $useReadPdo

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

Генератор

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)

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

protected float getElapsedTime(int $start)

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

Parameters

int $start

Return Value

float

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

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

Parameters

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

Return Value

void

void allowQueryDurationHandlersToRunAgain()

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

Return Value

void

float totalQueryDuration()

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

Return Value

float

void resetTotalQueryDuration()

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

Return Value

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.

Параметры

строка $value

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

строка

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

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

Обработчик запросов getPostProcessor()

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

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

Обработчик запросов

$this setPostProcessor(Обработчик запросов $processor)

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

Параметры

Обработчик запросов $processor

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

$this

Диспетчер событий getEventDispatcher()

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

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

Диспетчер событий

$this setEventDispatcher(Диспетчер событий $events)

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

Параметры

Диспетчер событий $events

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

$this

void unsetEventDispatcher()

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

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

void

$this setTransactionManager(Менеджер транзакций БД $manager)

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

Параметры

Менеджер транзакций БД $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

Грамматика withTablePrefix(Грамматика $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

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

Spec-Zone.ru

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