Подключение

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

Свойства

protected PDO	$pdo	Активное подключение PDO.
protected PDO	$readPdo	Активное подключение PDO, используемое для чтения.
protected callable	$reconnector	Экземпляр реконнектора для подключения.
protected Grammar	$queryGrammar	Реализация синтаксического анализа запросов.
protected Grammar	$schemaGrammar	Реализация синтаксического анализа схемы.
protected Processor	$postProcessor	Реализация постобработчика запросов.
protected Dispatcher	$events	Экземпляр диспетчера событий.
protected int	$fetchMode	Режим извлечения по умолчанию подключения.
protected mixed	$fetchArgument	Аргумент для режима извлечения.
protected array	$fetchConstructorArgument	Аргументы конструктора для режима извлечения PDO::FETCH_CLASS.
protected int	$transactions	Количество активных транзакций.
protected array	$queryLog	Все запросы, выполненные к подключению.
protected bool	$loggingQueries	Указывает, ведётся ли регистрация запросов.
protected bool	$pretending	Указывает, находится ли подключение в режиме "сухого прогона".
protected string	$database	Имя подключенной базы данных.
protected Connection	$doctrineConnection	Экземпляр подключения Doctrine.
protected string	$tablePrefix	Префикс таблицы для подключения.
protected array	$config	Параметры конфигурации подключения к базе данных.

Методы

bool	causedByDeadlock(Exception $e) Определить, было ли данное исключение вызвано тупиковой ситуацией.	из DetectsDeadlocks
bool	causedByLostConnection(Exception $e) Определить, было ли данное исключение вызвано потерей соединения.	из DetectsLostConnections
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() Получить новый экземпляр конструктора запросов.
Expression	raw(mixed $value) Получить новое выражение SQL.
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 в базе данных и вернуть генератор.
void	bindValues(PDOStatement $statement, array $bindings) Привязать значения к параметрам в данном операторе.
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	prepareBindings(array $bindings) Подготовить параметры запроса для выполнения.
mixed	transaction(Closure $callback, int $attempts = 1) Выполнить замыкание в рамках транзакции.
void	beginTransaction() Начать новую транзакцию базы данных.
void	commit() Завершить активную транзакцию базы данных.
void	rollBack() Отменить активную транзакцию базы данных.
int	transactionLevel() Получить количество активных транзакций.
array	pretend(Closure $callback) Выполнить переданное замыкание в режиме «сухого прогона».
mixed	run(string $query, array $bindings, Closure $callback) Выполнить SQL-запрос и залогировать контекст его выполнения.
mixed	runQueryCallback(string $query, array $bindings, Closure $callback) Выполнить SQL-запрос.
mixed	tryAgainIfCausedByLostConnection(QueryException $e, string $query, array $bindings, Closure $callback) Обработать исключение запроса, возникшее во время выполнения.
void	disconnect() Отключиться от базового подключения PDO.
void	reconnect() Переподключиться к базе данных.
void	reconnectIfMissingConnection() Переподключиться к базе данных, если отсутствует подключение PDO.
void	logQuery(string $query, array $bindings, float\|null $time = null) Залогировать запрос в журнале запросов подключения.
void	listen(Closure $callback) Зарегистрировать слушатель запросов базы данных для подключения.
void	fireConnectionEvent(string $event) Вызвать событие для этого подключения.

float	getElapsedTime(int $start) Получить время, прошедшее с заданной точки отсчёта.
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\|null $pdo) Установить подключение PDO.
$this	setReadPdo(PDO\|null $pdo) Установить подключение PDO, используемое для чтения.
$this	setReconnector(callable $reconnector) Установить экземпляр повторного подключения к соединению.
string\|null	getName() Получить имя подключения к базе данных.
mixed	getConfig(string $option) Получить опцию из конфигурации.
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() Определить, находится ли подключение в режиме "сухого запуска".
int	getFetchMode() Получить режим выборки по умолчанию для подключения.
mixed	getFetchArgument() Получить аргумент выборки, который будет применяться при выборке.
array	getFetchConstructorArgument() Получить пользовательские аргументы конструктора для режима выборки PDO::FETCH_CLASS.
int	setFetchMode(int $fetchMode, mixed $fetchArgument = null, array $fetchConstructorArgument = []) Установить режим выборки по умолчанию для подключения и необязательные аргументы для данного режима выборки.
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) Установить префикс таблиц и вернуть синтаксический анализатор.

Details

protected bool causedByDeadlock(Exception $e)

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

Parameters

Exception

Return Value

bool

protected bool causedByLostConnection(Exception $e)

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

Parameters

Exception

Return Value

bool

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

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

Parameters

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

Return Value

void

END_OF_DOCUMENT_MARKER

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

Expression raw(mixed $value)

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

Параметры

mixed

$value

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

Expression

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

void bindValues(PDOStatement $statement, array $bindings)

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

Параметры

PDOStatement	$statement
array	$bindings

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

void

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

END_OF_DOCUMENT_MARKER

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

array prepareBindings(array $bindings)

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

Parameters

array

$bindings

Return Value

array

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

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

Parameters

Closure	$callback
int	$attempts

Return Value

mixed

Exceptions

Throwable

void beginTransaction()

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

Return Value

void

Exceptions

Exception

void commit()

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

Return Value

void

void rollBack()

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

Return Value

void

int transactionLevel()

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

Return Value

int

array pretend(Closure $callback)

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

Parameters

Closure

$callback

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

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

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

Return Value

void

void reconnect()

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

Return Value

void

Exceptions

LogicException

protected void reconnectIfMissingConnection()

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

Return Value

void

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

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

Parameters

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

Return Value

void

void listen(Closure $callback)

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

Parameters

Closure

$callback

Return Value

void

protected void fireConnectionEvent(string $event)

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

Parameters

string

$event

Return Value

void

protected float getElapsedTime(int $start)

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

Parameters

int

$start

Return Value

float

bool isDoctrineAvailable()

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

Return Value

bool

Столбец getDoctrineColumn(string $table, string $column)

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

Параметры

string	$table
string	$column

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

Column

AbstractSchemaManager getDoctrineSchemaManager()

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

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

AbstractSchemaManager

Подключение getDoctrineConnection()

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

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

Подключение

PDO getPdo()

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

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

PDO

PDO getReadPdo()

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

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

PDO

$this setPdo(PDO|null $pdo)

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

Параметры

PDO|null

$pdo

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

$this

$this setReadPdo(PDO|null $pdo)

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

Параметры

PDO|null

$pdo

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

$this

$this setReconnector(callable $reconnector)

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

Параметры

callable

$reconnector

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

$this

Имя|null getName()

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

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

string|null

смешанный getConfig(string $option)

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

Параметры

string

$option

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

смешанный

Строка getDriverName()

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

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

Строка

Грамматика getQueryGrammar()

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

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

Грамматика

пустое значение setQueryGrammar(Грамматика $grammar)

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

Параметры

Грамматика

$grammar

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

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

Грамматика getSchemaGrammar()

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

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

Грамматика

пустое значение setSchemaGrammar(Грамматика $grammar)

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

Параметры

Грамматика

$grammar

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

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

Обработчик getPostProcessor()

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

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

Обработчик

пустое значение setPostProcessor(Обработчик $processor)

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

Параметры

Обработчик

$processor

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

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

Диспечер getEventDispatcher()

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

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

Диспечер

пустое значение setEventDispatcher(Диспечер $events)

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

Параметры

Диспечер

$events

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

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

Логическое значение pretending()

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

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

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

Целое число getFetchMode()

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

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

Целое число

смешанный getFetchArgument()

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

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

смешанный

Массив getFetchConstructorArgument()

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

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

Массив

int setFetchMode(int $fetchMode, mixed $fetchArgument = null, array $fetchConstructorArgument = [])

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

Параметры

int	$fetchMode
mixed	$fetchArgument
array	$fetchConstructorArgument

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

int

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

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

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

Параметры

Грамматика

$grammar

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

Грамматика

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