PostgresConnection

класс PostgresConnection расширяет Connection (Просмотреть исходный код)

Трейты

Свойства

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

Методы

bool	causedByDeadlock(Exception $e) Определить, была ли данная ошибка вызвана тупиковой ситуацией.	from DetectsDeadlocks
bool	causedByLostConnection(Throwable $e) Определить, была ли данная ошибка вызвана потерей соединения.	from DetectsLostConnections
mixed	transaction(Closure $callback, int $attempts = 1) Выполнить Closure в рамках транзакции.	from ManagesTransactions
void	handleTransactionException(Exception $e, int $currentAttempt, int $maxAttempts) Обработать ошибку, возникшую при выполнении транзакционной операции.	from ManagesTransactions
void	beginTransaction() Начать новую базу данных транзакции.	from ManagesTransactions
void	createTransaction() Создать транзакцию в базе данных.	from ManagesTransactions
void	createSavepoint() Создать точку сохранения в базе данных.	from ManagesTransactions
void	handleBeginTransactionException(Throwable $e) Обработать ошибку, возникшую при начале транзакции.	from ManagesTransactions
void	commit() Подтвердить активную базу данных транзакции.	from ManagesTransactions
void	rollBack(int\|null $toLevel = null) Откатить активную базу данных транзакции.	from ManagesTransactions
void	performRollBack(int $toLevel) Выполнить откат в базе данных.	from ManagesTransactions
handleRollBackException(Exception $e) Обработать ошибку, возникшую при откате.	from ManagesTransactions
int	transactionLevel() Получить количество активных транзакций.	from ManagesTransactions

void	__construct(PDO\|Closure $pdo, string $database = '', string $tablePrefix = '', array $config = []) Создать новый экземпляр подключения к базе данных.	из Connection
void	useDefaultQueryGrammar() Установить синтаксический анализатор запросов по умолчанию.	из Connection
Grammar	getDefaultQueryGrammar() Получить экземпляр синтаксического анализатора запросов по умолчанию.
void	useDefaultSchemaGrammar() Установить синтаксический анализатор схем по умолчанию.	из Connection
Grammar	getDefaultSchemaGrammar() Получить экземпляр синтаксического анализатора схем по умолчанию.
void	useDefaultPostProcessor() Установить обработчик запросов по умолчанию.	из Connection
Processor	getDefaultPostProcessor() Получить экземпляр обработчика запросов по умолчанию.
Builder	getSchemaBuilder() Получить экземпляр генератора схемы для подключения.
Builder	table(string $table) Начать флуентный запрос к таблице базы данных.	из Connection
Builder	query() Получить новый экземпляр билдера запросов.	из Connection
mixed	selectOne(string $query, array $bindings = [], bool $useReadPdo = true) Выполнить запрос SELECT и вернуть единственный результат.	из Connection
array	selectFromWriteConnection(string $query, array $bindings = []) Выполнить запрос SELECT к базе данных.	из Connection
array	select(string $query, array $bindings = [], bool $useReadPdo = true) Выполнить запрос SELECT к базе данных.	из Connection
Generator	cursor(string $query, array $bindings = [], bool $useReadPdo = true) Выполнить запрос SELECT к базе данных и вернуть генератор.	из Connection
PDOStatement	prepared(PDOStatement $statement) Настроить подготовленное выражение PDO.	из Connection

PDO	getPdoForSelect(bool $useReadPdo = true) Получить подключение PDO для запроса выбора.	from Connection
bool	insert(string $query, array $bindings = []) Выполнить операцию вставки в базу данных.	from Connection
int	update(string $query, array $bindings = []) Выполнить операцию обновления в базе данных.	from Connection
int	delete(string $query, array $bindings = []) Выполнить операцию удаления из базы данных.	from Connection
bool	statement(string $query, array $bindings = []) Выполнить SQL-запрос и вернуть булево значение результата.	from Connection
int	affectingStatement(string $query, array $bindings = []) Выполнить SQL-запрос и получить количество затронутых строк.	from Connection
bool	unprepared(string $query) Выполнить сырой, незаготовленный запрос к подключению PDO.	from Connection
array	pretend(Closure $callback) Выполнить переданный обратный вызов в режиме "сухого прогона".	from Connection
array	withFreshQueryLog(Closure $callback) Выполнить переданный обратный вызов в режиме "сухого прогона".	from Connection
void	bindValues(PDOStatement $statement, array $bindings) Связать значения с их параметрами в данном операторе.	from Connection
array	prepareBindings(array $bindings) Подготовить параметры запроса для выполнения.	from Connection
mixed	run(string $query, array $bindings, Closure $callback) Выполнить SQL-запрос и записать контекст его выполнения.	from Connection
mixed	runQueryCallback(string $query, array $bindings, Closure $callback) Выполнить SQL-запрос.	from Connection
void	logQuery(string $query, array $bindings, float\|null $time = null) Записать запрос в журнал запросов подключения.	from Connection
float	getElapsedTime(int $start) Получить время, прошедшее с заданной начальной точки.	from Connection

mixed	обработатьИсключениеЗапроса(Exception $e, string $query, array $bindings, Closure $callback) Обработать исключение запроса.	из подключения
mixed	повторитьПопыткуЕслиВызванаПотерейПодключения(QueryException $e, string $query, array $bindings, Closure $callback) Обработать исключение запроса, возникшее во время выполнения запроса.	из подключения
void	подключитьсяЗаново() Подключиться к базе данных заново.	из подключения
void	подключитьсяЗановоЕслиОтсутствуетПодключение() Подключиться к базе данных заново, если отсутствует соединение PDO.	из подключения
void	отключиться() Отключиться от базового соединения PDO.	из подключения
void	прослушивать(Closure $callback) Зарегистрировать слушателя запросов базы данных с подключением.	из подключения
array\|null	вызватьСобытиеПодключения(string $event) Вызвать событие для этого подключения.	из подключения
void	событие(mixed $event) Вызвать указанное событие, если это возможно.	из подключения
Expression	сырой(mixed $value) Получить новое выражение сырого запроса.	из подключения
void	записиБылиИзменены(bool $value = true) Указать, были ли изменены какие-либо записи.	из подключения
bool	доступенDoctrine() Доступен Doctrine?	из подключения
Column	получитьDoctrineColumn(string $table, string $column) Получить экземпляр Doctrine Schema Column.	из подключения
AbstractSchemaManager	получитьDoctrineSchemaManager() Получить менеджер схемы Doctrine DBAL для подключения.	из подключения
Connection	получитьDoctrineConnection() Получить экземпляр подключения к базе данных Doctrine DBAL.	из подключения
PDO	получитьPDO() Получить текущее соединение PDO.	из подключения

PDO	getReadPdo() Получить текущее подключение PDO, используемое для чтения.	from Connection
$this	setPdo(PDO\|Closure\|null $pdo) Установить подключение PDO.	from Connection
$this	setReadPdo(PDO\|Closure\|null $pdo) Установить подключение PDO, используемое для чтения.	from Connection
$this	setReconnector(callable $reconnector) Установить экземпляр повторного подключения к соединению.	from Connection
string\|null	getName() Получить имя подключения к базе данных.	from Connection
mixed	getConfig(string\|null $option = null) Получить параметр из параметров конфигурации.	from Connection
string	getDriverName() Получить имя драйвера PDO.	from Connection
Grammar	getQueryGrammar() Получить синтаксический анализатор запросов, используемый подключением.	from Connection
$this	setQueryGrammar(Grammar $grammar) Установить синтаксический анализатор запросов, используемый подключением.	from Connection
Grammar	getSchemaGrammar() Получить синтаксический анализатор схемы, используемый подключением.	from Connection
$this	setSchemaGrammar(Grammar $grammar) Установить синтаксический анализатор схемы, используемый подключением.	from Connection
Processor	getPostProcessor() Получить пост-процессор запросов, используемый подключением.	from Connection
$this	setPostProcessor(Processor $processor) Установить пост-процессор запросов, используемый подключением.	from Connection
Dispatcher	getEventDispatcher() Получить диспетчер событий, используемый подключением.	from Connection

$this	setEventDispatcher(Dispatcher $events) Установить экземпляр диспетчера событий в соединении.	from Connection
void	unsetEventDispatcher() Удалить диспетчер событий для этого соединения.	from Connection
bool	pretending() Определить, находится ли соединение в режиме "сухого запуска".	from Connection
array	getQueryLog() Получить журнал запросов соединения.	from Connection
void	flushQueryLog() Очистить журнал запросов.	from Connection
void	enableQueryLog() Включить журнал запросов для соединения.	from Connection
void	disableQueryLog() Отключить журнал запросов для соединения.	from Connection
bool	logging() Определить, ведём ли мы логирование запросов.	from Connection
string	getDatabaseName() Получить имя подключенной базы данных.	from Connection
$this	setDatabaseName(string $database) Установить имя подключенной базы данных.	from Connection
string	getTablePrefix() Получить префикс таблицы для соединения.	from Connection
$this	setTablePrefix(string $prefix) Установить используемый префикс таблицы для соединения.	from Connection
Grammar	withTablePrefix(Grammar $grammar) Установить префикс таблицы и вернуть синтаксический анализатор.	from Connection
static void	resolverFor(string $driver, Closure $callback) Зарегистрировать решатель соединения.	from Connection
static mixed	getResolver(string $driver) Получить решатель соединения для заданного драйвера.	from Connection
Driver	getDoctrineDriver() Получить драйвер Doctrine DBAL.

Подробности

protected bool causedByDeadlock(Exception $e)

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

Параметры

Exception

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

bool

protected bool causedByLostConnection(Throwable $e)

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

Параметры

Throwable

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

bool

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

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

Параметры

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

Исключения

Exception

protected void performRollBack(int $toLevel)

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

Параметры

int

$toLevel

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

void

protected handleRollBackException(Exception $e)

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

Параметры

Exception

Исключения

Exception

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 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

END_OF_DOCUMENT_MARKER

protected PDO getPdoForSelect(bool $useReadPdo = true)

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

Параметры

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-запрос и вернуть результат (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

array pretend(Closure $callback)

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

Параметры

Closure

$callback

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

array

protected array withFreshQueryLog(Closure $callback)

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

Параметры

Closure

$callback

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

array

void bindValues(PDOStatement $statement, array $bindings)

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

Параметры

PDOStatement	$statement
array	$bindings

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

void

array prepareBindings(array $bindings)

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

Параметры

array

$bindings

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

array

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

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

Параметры

string	$query
array	$bindings
Closure	$callback

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

mixed

Исключения

QueryException

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

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

Параметры

string	$query
array	$bindings
Closure	$callback

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

mixed

Исключения

QueryException

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

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

Параметры

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

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

void

protected float getElapsedTime(int $start)

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

Параметры

int

$start

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

float

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

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

Параметры

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

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

mixed

Исключения

Exception

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

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

Параметры

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

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

mixed

Исключения

QueryException

void reconnect()

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

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

void

Исключения

LogicException

protected void reconnectIfMissingConnection()

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

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

void

void disconnect()

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

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

void

void listen(Closure $callback)

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

Параметры

Closure

$callback

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

void

protected array|null fireConnectionEvent(string $event)

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

Параметры

string

$event

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

array|null

protected void event(mixed $event)

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

Параметры

mixed

$event

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

void

Expression raw(mixed $value)

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

Параметры

mixed

$value

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

Expression

void recordsHaveBeenModified(bool $value = true)

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

Параметры

bool

$value

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

void

bool isDoctrineAvailable()

Doctrine доступен?

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

bool

Column getDoctrineColumn(string $table, string $column)

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

Parameters

string	$table
string	$column

Return Value

Column

AbstractSchemaManager getDoctrineSchemaManager()

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

Return Value

AbstractSchemaManager

Connection getDoctrineConnection()

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

Return Value

Connection

PDO getPdo()

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

Return Value

PDO

PDO getReadPdo()

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

Return Value

PDO

$this setPdo(PDO|Closure|null $pdo)

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

Parameters

PDO|Closure|null

$pdo

Return Value

$this

$this setReadPdo(PDO|Closure|null $pdo)

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

Parameters

PDO|Closure|null

$pdo

Return Value

$this

$this setReconnector(callable $reconnector)

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

Parameters

callable

$reconnector

Return Value

$this

string|null getName()

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

Return Value

string|null

mixed getConfig(string|null $option = null)

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

Parameters

string|null

$option

Return Value

mixed

string getDriverName()

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

Return Value

string

Грамматика запроса getQueryGrammar()

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

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

Грамматика запроса

$this setQueryGrammar(Грамматика запроса $grammar)

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

Параметры

Грамматика запроса

$grammar

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

$this

Грамматика схемы getSchemaGrammar()

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

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

Грамматика схемы

$this setSchemaGrammar(Грамматика схемы $grammar)

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

Параметры

Грамматика схемы

$grammar

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

$this

Обработчик запросов getPostProcessor()

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

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

Обработчик запросов

$this setPostProcessor(Обработчик запросов $processor)

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

Параметры

Обработчик запросов

$processor

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

$this

Диспетчер событий getEventDispatcher()

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

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

Диспетчер событий

$this setEventDispatcher(Диспетчер событий $events)

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

Параметры

Диспетчер событий

$events

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

$this

void unsetEventDispatcher()

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

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

void

bool pretending()

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

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

bool

array getQueryLog()

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

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

array

void flushQueryLog()

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

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

void

void enableQueryLog()

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

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

void

void disableQueryLog()

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

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

void

bool logging()

Определить, ведется ли регистрация запросов.

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

bool

string getDatabaseName()

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

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

string

$this setDatabaseName(string $database)

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

Параметры

string

$database

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

$this

string getTablePrefix()

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

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

string

$this setTablePrefix(string $prefix)

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

Параметры

string

$prefix

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

$this

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

protected Driver getDoctrineDriver()

Получить драйвер Doctrine DBAL.

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

Driver

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