Spec-Zone.ru › Laravel 11

MySqlConnection

класс MySqlConnection расширяет 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
защищенный bool $recordsModified

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

из Connection
защищенный bool $readOnWriteConnection

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

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

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

из Connection
защищенный bool $loggingQueries

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

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

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

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

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

из Connection
защищенный bool $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)

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

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

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

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.

из Connection
PDO|Closure|null getRawPdo()

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

из Connection
PDO getReadPdo()

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

из Connection
PDO|Closure|null getRawReadPdo()

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

из Connection
$this setPdo(PDO|Closure|null $pdo)

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

из Connection
$this setReadPdo(PDO|Closure|null $pdo)

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

из Connection
$this setReconnector(callable $reconnector)

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

из Connection
string|null getName()

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

из Connection
string|null getNameWithReadWriteType()

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

из Connection
mixed getConfig(string|null $option = null)

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

из Connection
string getDriverName()

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

из Connection
Grammar getQueryGrammar()

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

из Connection
$this setQueryGrammar(Grammar $grammar)

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

из Connection
Grammar getSchemaGrammar()

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

из Connection
$this setSchemaGrammar(Grammar $grammar)

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

из Connection
Processor getPostProcessor()

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

из Connection
$this setPostProcessor(Processor $processor)

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

из Connection
Dispatcher getEventDispatcher()

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

из Connection
$this setEventDispatcher(Dispatcher $events)

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

из Connection
void unsetEventDispatcher()

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

из Connection
$this setTransactionManager(DatabaseTransactionsManager $manager)

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

из Connection
void unsetTransactionManager()

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

из Connection
bool pretending()

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

из Connection
array getQueryLog()

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

из Connection
array getRawQueryLog()

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

из Connection
void flushQueryLog()

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

из Connection
void enableQueryLog()

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

из Connection
void disableQueryLog()

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

из Connection
bool logging()

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

из 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()

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

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

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

из Connection
static mixed getResolver(string $driver)

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

из Connection
bool isMaria()

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

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

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

Параметры

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

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

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

bool isMaria()

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

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

bool

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

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

Параметры

Filesystem|null $files
callable|null $processFactory

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

MySqlSchemaState

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

Spec-Zone.ru

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