Spec-Zone.ru › Laravel 10

MySqlConnection

класс MySqlConnection расширяет Connection (Просмотреть исходный код)

Трейты

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
protected массив $queryLog

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

 из Connection
protected bool $loggingQueries

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

 из Connection
protected float $totalQueryDuration

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

 из Connection
protected массив $queryDurationHandlers

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

 из Connection
protected bool $pretending

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

 из Connection
protected Closure[] $beforeStartingTransaction

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

 из Connection
protected Closure[] $beforeExecutingCallbacks

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

 из Connection
protected Connection $doctrineConnection

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

 из Connection
protected массив $doctrineTypeMappings

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

 из Connection
static protected Closure[] $resolvers

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

 из Connection

Методы

bool causedByConcurrencyError(Throwable $e)

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

 from DetectsConcurrencyErrors
bool causedByLostConnection(Throwable $e)

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

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

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

 from ManagesTransactions
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 timestamp) "доступно в".

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

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

 из Connection
void useDefaultQueryGrammar()

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

 из Connection
Grammar getDefaultQueryGrammar()

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

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

 из Connection
Grammar|null getDefaultSchemaGrammar()

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

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

 из Connection
Processor getDefaultPostProcessor()

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

Получить экземпляр конструктора схем для подключения.
Builder table(Closure|Builder|string $table, string|null $as = null)

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

 из Connection
Builder query()

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

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

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

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

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

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

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

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

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

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

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

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

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

 из Connection
PDOStatement prepared(PDOStatement $statement)

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

 из Connection
PDO getPdoForSelect(bool $useReadPdo = true)

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

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

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

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

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

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

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

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

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

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

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

 из Connection
bool unprepared(string $query)

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

 из Connection
array pretend(Closure $callback)

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

 из Connection
mixed withoutPretending(Closure $callback)

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

 из Connection
array withFreshQueryLog(Closure $callback)

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

 из Connection
void bindValues(PDOStatement $statement, array $bindings)

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

 из 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-запрос.

 from Connection
bool isUniqueConstraintError(Exception $exception)

Определить, вызвано ли данное исключение базы данных нарушением уникального ограничения.
void logQuery(string $query, array $bindings, float|null $time = null)

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

 from Connection
float getElapsedTime(int $start)

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

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

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

 from Connection
void allowQueryDurationHandlersToRunAgain()

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

 from Connection
float totalQueryDuration()

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

 from Connection
void resetTotalQueryDuration()

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

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

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

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

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

 from Connection
mixed|false reconnect()

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

 from Connection
void reconnectIfMissingConnection()

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

 from Connection
void disconnect()

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

 from Connection
$this beforeStartingTransaction(Closure $callback)

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

 from Connection
$this beforeExecuting(Closure $callback)

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

 from Connection
void listen(Closure $callback)

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

 from Connection
array|null fireConnectionEvent(string $event)

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

 from Connection
void event(mixed $event)

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

 from Connection
Expression raw(mixed $value)

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

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

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

 from Connection
string escapeString(string $value)

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

 from Connection
string escapeBool(bool $value)

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

 from Connection
string escapeBinary(string $value)

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

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

 from Connection
void recordsHaveBeenModified(bool $value = true)

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

 from Connection
$this setRecordModificationState(bool $value)

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

 from Connection
void forgetRecordModificationState()

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

 from Connection
$this useWriteConnectionWhenReading(bool $value = true)

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

 from Connection
bool isDoctrineAvailable()

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

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

Получить текущий параметр 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
строка|null getName()

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

 from Connection
строка|null getNameWithReadWriteType()

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

 from Connection
смешанное getConfig(строка|null $option = null)

Получить опцию из конфигурационных опций.

 from Connection
строка getDriverName()

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

 from Connection
Grammar getQueryGrammar()

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

 from Connection
$this setQueryGrammar(Grammar $grammar)

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

 from Connection
Grammar getSchemaGrammar()

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

 from Connection
$this setSchemaGrammar(Grammar $grammar)

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

 from Connection
Processor getPostProcessor()

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

 from Connection
$this setPostProcessor(Processor $processor)

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

 from Connection
Dispatcher getEventDispatcher()

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

 from Connection
$this setEventDispatcher(Dispatcher $events)

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

 from Connection
void unsetEventDispatcher()

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

 from Connection
$this setTransactionManager(DatabaseTransactionsManager $manager)

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

 from Connection
void unsetTransactionManager()

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

 from Connection
bool pretending()

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

 from Connection
array getQueryLog()

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

 from Connection
array getRawQueryLog()

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

 from Connection
void flushQueryLog()

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

 from Connection
void enableQueryLog()

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

 from Connection
void disableQueryLog()

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

 from Connection
bool logging()

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

 from Connection
string getDatabaseName()

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

 from Connection
$this setDatabaseName(string $database)

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

 from Connection
$this setReadWriteType(string|null $readWriteType)

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

 from Connection
string getTablePrefix()

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

 from Connection
$this setTablePrefix(string $prefix)

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

 from Connection
Grammar withTablePrefix(Grammar $grammar)

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

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

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

 from Connection
static mixed getResolver(string $driver)

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

 из Connection
bool isMaria()

Определить, является ли подключенная база данных базой данных MariaDB.
MySqlSchemaState getSchemaState(Filesystem $files = null, callable $processFactory = null)

Получить состояние схемы для подключения.
MySqlDriver 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

void commit()

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

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

void

Исключения

Throwable

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

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

Параметры

Throwable $e
int $currentAttempt
int $maxAttempts

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

void

Исключения

Throwable

void rollBack(int|null $toLevel = null)

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

Параметры

int|null $toLevel

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

void

Исключения

Throwable

protected void performRollBack(int $toLevel)

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

Параметры

int $toLevel

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

void

Исключения

Throwable

protected void handleRollBackException(Throwable $e)

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

Параметры

Throwable $e

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

void

Исключения

Throwable

int transactionLevel()

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

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

int

void afterCommit(callable $callback)

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

Параметры

callable $callback

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

void

Исключения

RuntimeException

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

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

Параметры

DateTimeInterface|DateInterval|int $delay

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

int

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

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

Параметры

DateTimeInterface|DateInterval|int $delay

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

int

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

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

Параметры

DateTimeInterface|DateInterval|int $delay

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

DateTimeInterface|int

protected int currentTime()

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

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

int

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

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

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

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

Построитель

Построитель table(Closure|Построитель|string $table, string|null $as = null)

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

Параметры

Closure|Построитель|string $table
string|null $as

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

Построитель

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

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

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

Построитель

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 в базе данных и вернуть генератор.

Parameters

string $query
array $bindings
bool $useReadPdo

Return Value

Generator

protected PDOStatement prepared(PDOStatement $statement)

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

Parameters

PDOStatement $statement

Return Value

PDOStatement

protected PDO getPdoForSelect(bool $useReadPdo = true)

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

Parameters

bool $useReadPdo

Return Value

PDO

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

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

Parameters

string $query
array $bindings

Return Value

bool

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

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

Parameters

string $query
array $bindings

Return Value

int

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

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

Parameters

string $query
array $bindings

Return Value

int

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

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

Parameters

string $query
array $bindings

Return Value

bool

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

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

Parameters

string $query
array $bindings

Return Value

int

bool unprepared(string $query)

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

Parameters

string $query

Return Value

bool

массив pretend(Closure $callback)

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

Параметры

Closure $callback

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

массив

смешанный тип withoutPretending(Closure $callback)

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

Параметры

Closure $callback

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

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

protected массив withFreshQueryLog(Closure $callback)

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

Параметры

Closure $callback

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

массив

пустое значение bindValues(PDOStatement $statement, array $bindings)

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

Параметры

PDOStatement $statement
массив $bindings

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

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

массив prepareBindings(array $bindings)

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

Параметры

массив $bindings

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

массив

protected смешанный тип run(string $query, array $bindings, Closure $callback)

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

Параметры

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

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

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

Исключения

QueryException

protected смешанный тип runQueryCallback(string $query, array $bindings, Closure $callback)

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

Параметры

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

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

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

Исключения

QueryException

protected логическое значение isUniqueConstraintError(Exception $exception)

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

Параметры

Exception $exception

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

логическое значение

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.

Parameters

string $value

Return Value

string

protected string escapeBool(bool $value)

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

Parameters

bool $value

Return Value

string

protected string escapeBinary(string $value)

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

Parameters

string $value

Return Value

string

bool hasModifiedRecords()

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

Return Value

bool

void recordsHaveBeenModified(bool $value = true)

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

Parameters

bool $value

Return Value

void

$this setRecordModificationState(bool $value)

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

Parameters

bool $value

Return Value

$this

void forgetRecordModificationState()

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

Return Value

void

$this useWriteConnectionWhenReading(bool $value = true)

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

Parameters

bool $value

Return Value

$this

bool isDoctrineAvailable()

Doctrine доступен?

Return Value

bool

bool usingNativeSchemaOperations()

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

Return Value

bool

Column getDoctrineColumn(string $table, string $column)

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

Parameters

string $table
string $column

Return Value

Column

AbstractSchemaManager getDoctrineSchemaManager()

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

Return Value

AbstractSchemaManager

Соединение getDoctrineConnection()

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

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

Соединение

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

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

Параметры

Type|string $class
string $name
string $type

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

void

Исключения

Исключение
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
END_OF_DOCUMENT_MARKER

строка|null getName()

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

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

строка|null

строка|null getNameWithReadWriteType()

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

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

строка|null

смешанный тип getConfig(строка|null $option = null)

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

Параметры

строка|null $option

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

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

строка getDriverName()

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

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

строка

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

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

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

Значение возвращаемого значения

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

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

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

Параметры

Диспечер событий $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)

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

Parameters

string $database

Return Value

$this

$this setReadWriteType(string|null $readWriteType)

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

Parameters

string|null $readWriteType

Return Value

$this

string getTablePrefix()

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

Return Value

string

$this setTablePrefix(string $prefix)

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

Parameters

string $prefix

Return Value

$this

Grammar withTablePrefix(Grammar $grammar)

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

Parameters

Grammar $grammar

Return Value

Grammar

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

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

Parameters

string $driver
Closure $callback

Return Value

void

static mixed getResolver(string $driver)

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

Parameters

string $driver

Return Value

mixed

bool isMaria()

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

Return Value

bool

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

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

Parameters

Filesystem $files
callable $processFactory

Return Value

MySqlSchemaState

protected MySqlDriver getDoctrineDriver()

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

Return Value

MySqlDriver

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

Spec-Zone.ru

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