Spec-Zone.ru › Laravel 5.7

Подключение

класс Connection реализует ConnectionInterface (Просмотр исходного кода)

Трейты

DetectsDeadlocks
DetectsLostConnections
ManagesTransactions

Свойства

protected PDO|Closure $pdo Активное подключение PDO.
protected PDO|Closure $readPdo Активное подключение PDO, используемое для чтений.
protected string $database Имя подключенной базы данных.
protected string $tablePrefix Префикс таблиц для подключения.
protected array $config Параметры конфигурации подключения к базе данных.
protected callable $reconnector Объект-переподключатель для подключения.
protected Grammar $queryGrammar Реализация грамматики запросов.
protected Grammar $schemaGrammar Реализация грамматики схем.
protected Processor $postProcessor Реализация постпроцессора запросов.
protected Dispatcher $events Экземпляр диспетчера событий.
protected int $fetchMode Режим извлечения по умолчанию для подключения.
protected int $transactions Количество активных транзакций.
protected int $recordsModified Указывает, были ли внесены изменения в базу данных.
protected array $queryLog Все запросы, выполненные к подключению.
protected bool $loggingQueries Указывает, регистрируются ли запросы.
protected bool $pretending Указывает, находится ли подключение в режиме «сухого прогона».
protected Connection $doctrineConnection Экземпляр подключения Doctrine.
static protected array $resolvers Резолверы подключений.

Методы

bool causedByDeadlock(Exception $e)

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

 из DetectsDeadlocks
bool causedByLostConnection(Throwable $e)

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

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

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

 из ManagesTransactions
void handleTransactionException(Exception $e, int $currentAttempt, int $maxAttempts)

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

 из ManagesTransactions
void beginTransaction()

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

 из ManagesTransactions
void createTransaction()

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

 из ManagesTransactions
void createSavepoint()

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

 из ManagesTransactions
void handleBeginTransactionException(Throwable $e)

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

 из ManagesTransactions
void commit()

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

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

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

 из ManagesTransactions
void performRollBack(int $toLevel)

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

 из ManagesTransactions
handleRollBackException(Exception $e)

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

 из ManagesTransactions
int transactionLevel()

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

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

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

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

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

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

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

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

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

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

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

Получить новый экземпляр генератора запросов.
mixed selectOne(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 к базе данных.
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 и вернуть результат boolean.
int affectingStatement(string $query, array $bindings = [])

Выполнить оператор SQL и получить количество затронутых строк.
bool unprepared(string $query)

Выполнить неподготовленное SQL-запрос к подключению PDO.
array pretend(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-запрос.
void logQuery(string $query, array $bindings, float|null $time = null)

Залогировать запрос в журнале запросов подключения.
float getElapsedTime(int $start)

Получить время, прошедшее с заданного начального момента.
mixed handleQueryException(Exception $e, string $query, array $bindings, Closure $callback)

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

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

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

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

Отключиться от базового подключения PDO.
void listen(Closure $callback)

Зарегистрировать слушателя баз данных для запросов с подключением.
array|null fireConnectionEvent(string $event)

Вызвать событие для этого подключения.
void event(mixed $event)

Вызвать заданное событие, если это возможно.
Expression raw(mixed $value)

Получить новое выражение необработанного запроса.
void recordsHaveBeenModified(bool $value = true)

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

Доступен ли Doctrine?
Column getDoctrineColumn(string $table, string $column)

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

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

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

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

Получить текущее подключение PDO, используемое для чтения.
$this setPdo(PDO|Closure|null $pdo)

Установить подключение PDO.
$this setReadPdo(PDO|Closure|null $pdo)

Установить подключение PDO, используемое для чтения.
$this setReconnector(callable $reconnector)

Установить экземпляр переподключения в подключении.
string|null getName()

Получить имя подключения к базе данных.
mixed getConfig(string|null $option = null)

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

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

Получить грамматику запроса, используемую подключением.
$this setQueryGrammar(Grammar $grammar)

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

Получить грамматику схемы, используемую подключением.
$this setSchemaGrammar(Grammar $grammar)

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

Получить постпроцессор запросов, используемый подключением.
$this setPostProcessor(Processor $processor)

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

Получить диспетчер событий, используемый подключением.
$this setEventDispatcher(Dispatcher $events)

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

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

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

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

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

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

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

Определить, ведётся ли регистрация запросов.
string getDatabaseName()

Получить имя подключённой базы данных.
$this setDatabaseName(string $database)

Установить имя подключённой базы данных.
string getTablePrefix()

Получить префикс таблицы для соединения.
$this setTablePrefix(string $prefix)

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

Установить префикс таблицы и вернуть синтаксический анализатор.
static void resolverFor(string $driver, Closure $callback)

Зарегистрировать решатель соединений.
static mixed getResolver(string $driver)

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

Детали

protected bool causedByDeadlock(Exception $e)

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

Parameters

Exception $e

Return Value

bool

protected bool causedByLostConnection(Throwable $e)

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

Parameters

Throwable $e

Return Value

bool

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

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

Parameters

Closure $callback
int $attempts

Return Value

mixed

Exceptions

Throwable

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

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

Parameters

Exception $e
int $currentAttempt
int $maxAttempts

Return Value

void

Exceptions

Exception

void beginTransaction()

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

Return Value

void

Exceptions

Exception

protected void createTransaction()

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

Return Value

void

protected void createSavepoint()

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

Return Value

void

protected void handleBeginTransactionException(Throwable $e)

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

Parameters

Throwable $e

Return Value

void

Exceptions

Exception

void commit()

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

Return Value

void

void rollBack(int|null $toLevel = null)

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

Parameters

int|null $toLevel

Return Value

void

Exceptions

Exception

protected void performRollBack(int $toLevel)

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

Parameters

int $toLevel

Return Value

void

protected handleRollBackException(Exception $e)

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

Parameters

Exception $e

Exceptions

Exception

int transactionLevel()

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

Return Value

int

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

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

Parameters

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

Return Value

void

void useDefaultQueryGrammar()

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

Return Value

void

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

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

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

Грамматика

void useDefaultSchemaGrammar()

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

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

void

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

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

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

Грамматика

void useDefaultPostProcessor()

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

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

void

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

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

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

Обработчик

Билдер getSchemaBuilder()

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

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

Билдер

Билдер table(string $table)

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

Параметры

string $table

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

Билдер

Билдер query()

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

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

Билдер

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

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

Параметры

string $query
array $bindings
bool $useReadPdo

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

mixed

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

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

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

Параметры

string $query
array $bindings

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

bool

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

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

Параметры

string $query
array $bindings

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

int

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

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

Параметры

string $query
array $bindings

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

int

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

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

Параметры

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
END_OF_DOCUMENT_MARKER

массив pretend(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

пустое значение logQuery(string $query, array $bindings, float|null $time = null)

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

Параметры

строка $query
массив $bindings
float|null $time

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

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

protected число с плавающей точкой getElapsedTime(int $start)

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

Параметры

целое число $start

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

число с плавающей точкой

protected смешанный тип handleQueryException(Исключение $e, string $query, array $bindings, Closure $callback)

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

Параметры

Исключение $e
строка $query
массив $bindings
Closure $callback

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

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

Исключения

Исключение

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

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

Параметры

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

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

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

Исключения

QueryException

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

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

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

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

Исключения

LogicException

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

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

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

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

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

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

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

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

пустое значение listen(Closure $callback)

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

Параметры

Closure $callback

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

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

protected массив|null fireConnectionEvent(string $event)

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

Параметры

строка $event

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

массив|null

protected пустое значение event(mixed $event)

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

Параметры

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

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

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

Выражение raw(mixed $value)

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

Параметры

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

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

Выражение

пустое значение recordsHaveBeenModified(bool $value = true)

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

Параметры

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

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

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

bool isDoctrineAvailable()

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

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

bool

Column getDoctrineColumn(string $table, string $column)

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

Параметры

string $table
string $column

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

Column

AbstractSchemaManager getDoctrineSchemaManager()

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

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

AbstractSchemaManager

Connection getDoctrineConnection()

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

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

Connection

PDO getPdo()

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

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

PDO

PDO getReadPdo()

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

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

PDO

$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

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

bool pretending()

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

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

bool

массив getQueryLog()

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

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

массив

void flushQueryLog()

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

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

void

void enableQueryLog()

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

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

void

void disableQueryLog()

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

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

void

bool logging()

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

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

bool

строка getDatabaseName()

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

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

строка

$this setDatabaseName(строка $database)

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

Параметры

строка $database

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

$this

строка getTablePrefix()

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

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

строка

$this setTablePrefix(строка $prefix)

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

Параметры

строка $prefix

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

$this

Грамматика withTablePrefix(Грамматика $grammar)

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

Параметры

Грамматика $grammar

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

Грамматика

статический void resolverFor(строка $driver, Closure $callback)

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

Параметры

строка $driver
Closure $callback

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

void

статический смешанный getResolver(строка $driver)

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

Параметры

строка $driver

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

смешанный

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

Spec-Zone.ru

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