Соединение

класс 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 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	causedByLostConnection(Exception $e) Определить, вызвана ли данная ошибка потерей соединения.	from DetectsLostConnections
void	__construct(PDO $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) Получить новое выражение для необработанного запроса.
mixed	selectOne(string $query, array $bindings = []) Выполнить запрос выбора и вернуть единственный результат.
array	selectFromWriteConnection(string $query, array $bindings = []) Выполнить запрос выбора к базе данных.
array	select(string $query, array $bindings = [], bool $useReadPdo = true) Выполнить запрос выбора к базе данных.
PDO	getPdoForSelect(bool $useReadPdo = true) Получить соединение PDO для запроса выбора.
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	prepareBindings(array $bindings) Подготовить параметры запроса для выполнения.
mixed	transaction(Closure $callback) Выполнить замыкание внутри транзакции.
void	beginTransaction() Начать новую транзакцию базы данных.
void	commit() Зафиксировать активную транзакцию базы данных.
void	rollBack() Отменить активную транзакцию базы данных.
int	transactionLevel() Получить количество активных транзакций.
array	pretend(Closure $callback) Выполнить заданный 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() Получить режим извлечения по умолчанию для подключения.
int	setFetchMode(int $fetchMode) Установить режим извлечения по умолчанию для подключения.
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) Установить префикс таблицы и вернуть синтаксический анализатор.

Подробности

protected bool causedByLostConnection(Exception $e)

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

Parameters

Exception

Return Value

bool

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

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

Parameters

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

Return Value

void

void useDefaultQueryGrammar()

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

Return Value

void

protected Grammar getDefaultQueryGrammar()

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

Return Value

Grammar

void useDefaultSchemaGrammar()

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

Return Value

void

protected Grammar getDefaultSchemaGrammar()

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

Return Value

Grammar

void useDefaultPostProcessor()

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

Return Value

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

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

Параметры

string	$query
array	$bindings

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

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

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)

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

Параметры

string

$query

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

bool

array prepareBindings(array $bindings)

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

Параметры

array

$bindings

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

array

mixed transaction(Closure $callback)

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

Параметры

Closure

$callback

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

mixed

Исключения

Throwable

void beginTransaction()

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

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

void

Исключения

Exception

void commit()

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

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

void

void rollBack()

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

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

void

int transactionLevel()

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

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

int

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

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

Параметры

Closure

$callback

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

массив

protected смешанный тип run(строка $query, массив $bindings, Closure $callback)

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

Параметры

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

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

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

Исключения

QueryException

protected смешанный тип runQueryCallback(строка $query, массив $bindings, Closure $callback)

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

Параметры

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

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

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

Исключения

QueryException

protected смешанный тип tryAgainIfCausedByLostConnection(QueryException $e, строка $query, массив $bindings, Closure $callback)

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

Параметры

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

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

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

Исключения

QueryException

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

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

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

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

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

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

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

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

Исключения

LogicException

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

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

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

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

пустое значение logQuery(строка $query, массив $bindings, число с плавающей точкой|null $time = null)

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

Параметры

строка	$query
массив	$bindings
число с плавающей точкой\|null	$time

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

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

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

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

Параметры

Closure

$callback

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

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

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

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

Параметры

строка

$event

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

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

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

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

Параметры

целое число

$start

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

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

булево значение isDoctrineAvailable()

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

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

булево значение

Столбец getDoctrineColumn(строка $table, строка $column)

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

Параметры

строка	$table
строка	$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

Исключения

RuntimeException

$this setReadPdo(PDO|null $pdo)

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

Параметры

PDO|null

$pdo

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

$this

$this setReconnector(вызываемый объект $reconnector)

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

Параметры

вызываемый объект

$reconnector

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

$this

string|null getName()

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

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

string|null

mixed getConfig(string $option)

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

Параметры

string

$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

int getFetchMode()

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

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

int

int setFetchMode(int $fetchMode)

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

Параметры

int

$fetchMode

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

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

Grammar withTablePrefix(Grammar $grammar)

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

Параметры

Grammar

$grammar

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

Grammar

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