Подключение

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

Трейты

Свойства

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
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-оператор и вернуть логическое значение результата.
int	affectingStatement(string $query, array $bindings = []) Выполнить SQL-оператор и получить количество изменённых строк.
bool	unprepared(string $query) Выполнить исходный, неподготовленный запрос к соединению 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() Получить используемую грамматику запросов для подключения.
void	setQueryGrammar(Grammar $grammar) Установить используемую грамматику запросов для подключения.
Grammar	getSchemaGrammar() Получить используемую грамматику схемы для подключения.
void	setSchemaGrammar(Grammar $grammar) Установить используемую грамматику схемы для подключения.
Processor	getPostProcessor() Получить используемый процессор постобработки запросов для подключения.
void	setPostProcessor(Processor $processor) Установить используемый процессор постобработки запросов для подключения.
Dispatcher	getEventDispatcher() Получить используемый диспетчер событий для подключения.
void	setEventDispatcher(Dispatcher $events) Установить экземпляр диспетчера событий в подключении.
void	unsetEventDispatcher() Удалить диспетчер событий для этого подключения.
bool	pretending() Определить, находится ли подключение в режиме «сухого запуска».
array	getQueryLog() Получить журнал запросов подключения.
void	flushQueryLog() Очистить журнал запросов.
void	enableQueryLog() Включить журнал запросов для подключения.

void	disableQueryLog() Отключить логирование запросов к базе данных.
bool	logging() Определить, ведется ли логирование запросов.
string	getDatabaseName() Получить имя подключенной базы данных.
string	setDatabaseName(string $database) Установить имя подключенной базы данных.
string	getTablePrefix() Получить префикс таблицы для подключения.
void	setTablePrefix(string $prefix) Установить префикс таблицы, используемый подключением.
Grammar	withTablePrefix(Grammar $grammar) Установить префикс таблицы и вернуть синтаксический анализатор.
static void	resolverFor(string $driver, Closure $callback) Зарегистрировать решатель подключений.
static mixed	getResolver(string $driver) Получить решатель подключений для указанного драйвера.

Подробности

protected bool causedByDeadlock(Exception $e)

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

Параметры

Exception

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

bool

protected bool causedByLostConnection(Throwable $e)

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

Параметры

Throwable

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

bool

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

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

Параметры

Closure	$callback
int	$attempts

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

mixed

Исключения

Throwable

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

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

Параметры

Exception	$e
int	$currentAttempt
int	$maxAttempts

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

void

Исключения

Exception

void beginTransaction()

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

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

void

Исключения

Exception

protected void createTransaction()

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

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

void

protected void createSavepoint()

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

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

void

protected void handleBeginTransactionException(Throwable $e)

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

Параметры

Throwable

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

void

Исключения

Exception

void commit()

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

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

void

void rollBack(int|null $toLevel = null)

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

Параметры

int|null

$toLevel

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

void

protected void performRollBack(int $toLevel)

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

Параметры

int

$toLevel

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

void

int transactionLevel()

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

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

int

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

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

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

Параметры

string	$query
array	$bindings
bool	$useReadPdo

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

Генератор

protected PDOStatement prepared(PDOStatement $statement)

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

Параметры

PDOStatement

$statement

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

PDOStatement

protected PDO getPdoForSelect(bool $useReadPdo = true)

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

Параметры

bool

$useReadPdo

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

PDO

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

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

Параметры

string	$query
array	$bindings

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

bool

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

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

Параметры

string	$query
array	$bindings

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

int

bool unprepared(string $query)

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

Параметры

string

$query

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

bool

array pretend(Замыкание $callback)

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

Параметры

Замыкание

$callback

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

array

protected array withFreshQueryLog(Замыкание $callback)

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

Параметры

Замыкание

$callback

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

array

void bindValues(PDOStatement $statement, array $bindings)

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

Parameters

PDOStatement	$statement
array	$bindings

Return Value

void

array prepareBindings(array $bindings)

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

Parameters

array

$bindings

Return Value

array

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

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

Parameters

string	$query
array	$bindings
Closure	$callback

Return Value

mixed

Exceptions

QueryException

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

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

Parameters

string	$query
array	$bindings
Closure	$callback

Return Value

mixed

Exceptions

QueryException

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

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

Parameters

string	$query
array	$bindings
float\|null	$time

Return Value

void

protected float getElapsedTime(int $start)

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

Parameters

int

$start

Return Value

float

protected mixed handleQueryException(Exception $e, string $query, array $bindings, Closure $callback)

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

Parameters

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

Return Value

mixed

Exceptions

Exception

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

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

Parameters

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

Return Value

mixed

Exceptions

QueryException

void reconnect()

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

Return Value

void

Exceptions

LogicException

protected void reconnectIfMissingConnection()

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

Return Value

void

void disconnect()

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

Return Value

void

void listen(Closure $callback)

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

Parameters

Closure

$callback

Return Value

void

protected array|null fireConnectionEvent(string $event)

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

Parameters

string

$event

Return Value

array|null

protected void event(mixed $event)

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

Parameters

mixed

$event

Return Value

void

Expression raw(mixed $value)

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

Parameters

mixed

$value

Return Value

Expression

void recordsHaveBeenModified(bool $value = true)

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

Parameters

bool

$value

Return Value

void

bool isDoctrineAvailable()

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

Return Value

bool

Column getDoctrineColumn(string $table, string $column)

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

Parameters

string	$table
string	$column

Return Value

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

void setQueryGrammar(Grammar $grammar)

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

Параметры

Grammar

$grammar

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

void

Grammar getSchemaGrammar()

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

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

Grammar

void setSchemaGrammar(Grammar $grammar)

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

Параметры

Grammar

$grammar

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

void

Processor getPostProcessor()

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

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

Processor

void setPostProcessor(Processor $processor)

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

Параметры

Processor

$processor

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

void

Dispatcher getEventDispatcher()

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

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

Dispatcher

void setEventDispatcher(Dispatcher $events)

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

Параметры

Dispatcher

$events

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

void

void unsetEventDispatcher()

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

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

void

bool pretending()

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

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

bool

array getQueryLog()

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

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

array

void flushQueryLog()

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

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

void

void enableQueryLog()

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

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

void

void disableQueryLog()

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

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

void

bool logging()

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

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

bool

string getDatabaseName()

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

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

string

string setDatabaseName(string $database)

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

Параметры

string

$database

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

string

string getTablePrefix()

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

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

string

void setTablePrefix(string $prefix)

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

Параметры

string

$prefix

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

void

Grammar withTablePrefix(Grammar $grammar)

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

Параметры

Grammar

$grammar

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

Grammar

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

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

Параметры

string	$driver
Closure	$callback

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

void

static mixed getResolver(string $driver)

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

Параметры

string

$driver

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

mixed

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