Подключение

класс 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(Exception $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(Exception $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 = []) Выполнить оператор вставки в базу данных.
int	update(string $query, array $bindings = []) Выполнить оператор обновления в базе данных.
int	delete(string $query, array $bindings = []) Выполнить оператор удаления в базе данных.
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) Установить экземпляр диспетчера событий для подключения.
bool	pretending() Определить, находится ли соединение в режиме «сухого запуска».
array	getQueryLog() Получить журнал запросов подключения.
void	flushQueryLog() Очистить журнал запросов.
void	enableQueryLog() Включить журнал запросов для подключения.
void	disableQueryLog() Отключить журнал запросов для подключения.
bool	logging() Определить, ведем ли мы логирование запросов.

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

Подробности

protected логическое causedByDeadlock(Exception $e)

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

Параметры

Exception

Значение результата

логическое

protected логическое causedByLostConnection(Exception $e)

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

Параметры

Exception

Значение результата

логическое

смешанный transaction(Closure $callback, int $attempts = 1)

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

Параметры

Closure	$callback
int	$attempts

Значение результата

смешанный

Исключения

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(Exception $e)

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

Параметры

Exception

Значение результата

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
строка	$database
строка	$tablePrefix
массив	$config

Значение результата

void

void useDefaultQueryGrammar()

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

Значение результата

void

protected Grammar getDefaultQueryGrammar()

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

Значение результата

Grammar

void useDefaultSchemaGrammar()

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

Значение результата

void

protected Grammar getDefaultSchemaGrammar()

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

Значение результата

Grammar

void useDefaultPostProcessor()

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

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

void

protected Processor getDefaultPostProcessor()

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

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

Processor

Builder getSchemaBuilder()

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

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

Builder

Builder table(string $table)

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

Параметры

string

$table

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

Builder

Builder query()

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

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

Builder

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

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

Параметры

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)

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

Параметры

string

$query

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

bool

array pretend(Closure $callback)

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

Параметры

Closure

$callback

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

array

protected array withFreshQueryLog(Closure $callback)

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

Параметры

Closure

$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

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.5/Illuminate/Database/Connection.html