Spec-Zone.ru › Laravel 9

PostgresConnection

class PostgresConnection extends Connection (View source)

Трейты

DetectsConcurrencyErrors
DetectsLostConnections
ManagesTransactions
InteractsWithTime
Macroable

Свойства

static protected array $macros

Зарегистрированные строковые макросы.

из Macroable
protected PDO|Closure $pdo

Активное подключение PDO.

из Connection
protected PDO|Closure $readPdo

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

из Connection
protected string $database

Имя подключенной базы данных.

из Connection
protected string|null $readWriteType

Тип подключения.

из Connection
protected string $tablePrefix

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

из Connection
protected array $config

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

из Connection
protected callable $reconnector

Экземпляр 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 DatabaseTransactionsManager $transactionsManager

Экземпляр менеджера транзакций.

из Connection
protected bool $recordsModified

Указывает, были ли внесены изменения в базу данных.

из Connection
protected bool $readOnWriteConnection

Указывает, должно ли подключение использовать подключение PDO "write".

из Connection
protected array $queryLog

Все запросы, выполненные к подключению.

из Connection
protected bool $loggingQueries

Указывает, ведется ли протоколирование запросов.

из Connection
protected float $totalQueryDuration

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

из Connection
protected array $queryDurationHandlers

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

из Connection
protected bool $pretending

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

из Connection
protected Closure[] $beforeExecutingCallbacks

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

из Connection
protected Connection $doctrineConnection

Экземпляр подключения Doctrine.

из Connection
protected array<string,string> $doctrineTypeMappings

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

из Connection
static protected Closure[] $resolvers

Резолверы подключений.

из Connection

Методы

bool causedByConcurrencyError(Throwable $e)

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

from DetectsConcurrencyErrors
bool causedByLostConnection(Throwable $e)

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

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

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

from ManagesTransactions
void handleTransactionException(Throwable $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
bool afterCommitCallbacksShouldBeExecuted()

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

from ManagesTransactions
void handleCommitTransactionException(Throwable $e, int $currentAttempt, int $maxAttempts)

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

from ManagesTransactions
void rollBack(int|null $toLevel = null)

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

from ManagesTransactions
void performRollBack(int $toLevel)

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

from ManagesTransactions
void handleRollBackException(Throwable $e)

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

from ManagesTransactions
int transactionLevel()

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

from ManagesTransactions
void afterCommit(callable $callback)

Выполнить обратный вызов после подтверждения транзакции.

from ManagesTransactions
int secondsUntil(DateTimeInterface|DateInterval|int $delay)

Получить количество секунд до заданного DateTime.

from InteractsWithTime
int availableAt(DateTimeInterface|DateInterval|int $delay = 0)

Получить временную метку UNIX «доступно в».

from InteractsWithTime
DateTimeInterface|int parseDateInterval(DateTimeInterface|DateInterval|int $delay)

Если заданное значение является интервалом, преобразовать его в экземпляр DateTime.

from InteractsWithTime
int currentTime()

Получить текущее системное время в виде временной метки UNIX.

from InteractsWithTime
static void macro(string $name, object|callable $macro)

Зарегистрировать пользовательское макро.

from Macroable
static void mixin(object $mixin, bool $replace = true)

Смешать другой объект в класс.

from Macroable
static bool hasMacro(string $name)

Проверяет, зарегистрировано ли макро.

from Macroable
static void flushMacros()

Очистить существующие макросы.

from Macroable
static mixed __callStatic(string $method, array $parameters)

Динамически обработать вызовы класса.

from Macroable
mixed __call(string $method, array $parameters)

Динамически обработать вызовы класса.

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

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

from Connection
void useDefaultQueryGrammar()

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

from Connection
Grammar getDefaultQueryGrammar()

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

void useDefaultSchemaGrammar()

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

from Connection
Grammar getDefaultSchemaGrammar()

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

void useDefaultPostProcessor()

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

from Connection
Processor getDefaultPostProcessor()

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

Builder getSchemaBuilder()

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

Builder table(Closure|Builder|string $table, string|null $as = null)

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

from Connection
Builder query()

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

from Connection
mixed selectOne(string $query, array $bindings = [], bool $useReadPdo = true)

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

from Connection
mixed scalar(string $query, array $bindings = [], bool $useReadPdo = true)

Выполнить инструкцию select и вернуть первый столбец первой строки.

from Connection
array selectFromWriteConnection(string $query, array $bindings = [])

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

from Connection
array select(string $query, array $bindings = [], bool $useReadPdo = true)

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

from Connection
Generator cursor(string $query, array $bindings = [], bool $useReadPdo = true)

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

from Connection
PDOStatement prepared(PDOStatement $statement)

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

from Connection
PDO getPdoForSelect(bool $useReadPdo = true)

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

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

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

from Connection
int update(string $query, array $bindings = [])

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

from Connection
int delete(string $query, array $bindings = [])

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

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
void whenQueryingForLongerThan(DateTimeInterface|CarbonInterval|float|int $threshold, callable $handler)

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

from Connection
void allowQueryDurationHandlersToRunAgain()

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

from Connection
float totalQueryDuration()

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

from Connection
void resetTotalQueryDuration()

Сбросить продолжительность всех выполненных запросов.

from Connection
mixed handleQueryException(QueryException $e, string $query, array $bindings, Closure $callback)

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

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

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

from Connection
mixed|false reconnect()

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

from Connection
void reconnectIfMissingConnection()

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

from Connection
void disconnect()

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

from Connection
$this beforeExecuting(Closure $callback)

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

from Connection
void listen(Closure $callback)

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

from Connection
array|null fireConnectionEvent(string $event)

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

from Connection
void event(mixed $event)

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

from Connection
Expression raw(mixed $value)

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

from Connection
bool hasModifiedRecords()

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

from Connection
void recordsHaveBeenModified(bool $value = true)

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

from Connection
$this setRecordModificationState(bool $value)

Установить состояние изменения записи.

from Connection
void forgetRecordModificationState()

Сбросить состояние изменения записи.

from Connection
$this useWriteConnectionWhenReading(bool $value = true)

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

from Connection
bool isDoctrineAvailable()

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

from Connection
bool usingNativeSchemaOperations()

Указывает, будут ли использоваться родные операции изменения схемы при удалении или переименовании столбцов, даже если Doctrine DBAL установлен.

from Connection
Column getDoctrineColumn(string $table, string $column)

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

from Connection
AbstractSchemaManager getDoctrineSchemaManager()

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

from Connection
Connection getDoctrineConnection()

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

from Connection
void registerDoctrineType(Type|string $class, string $name, string $type)

Зарегистрировать пользовательский тип отображения Doctrine.

from Connection
PDO getPdo()

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

from Connection
PDO|Closure|null getRawPdo()

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

from Connection
PDO getReadPdo()

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

from Connection
PDO|Closure|null getRawReadPdo()

Получить текущий параметр соединения 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
string|null getNameWithReadWriteType()

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

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
$this setTransactionManager(DatabaseTransactionsManager $manager)

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

from Connection
void unsetTransactionManager()

Сбросить менеджер транзакций для этого соединения.

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
$this setReadWriteType(string|null $readWriteType)

Установить тип чтения/записи соединения.

from Connection
string getTablePrefix()

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

from Connection
$this setTablePrefix(string $prefix)

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

из Connection
Grammar withTablePrefix(Grammar $grammar)

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

из Connection
static void resolverFor(string $driver, Closure $callback)

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

из Connection
static mixed getResolver(string $driver)

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

из Connection
PostgresSchemaState getSchemaState(Filesystem $files = null, callable $processFactory = null)

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

PostgresDriver getDoctrineDriver()

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

Подробности

protected bool causedByConcurrencyError(Throwable $e)

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

Параметры

Throwable $e

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

bool

protected bool causedByLostConnection(Throwable $e)

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

Параметры

Throwable $e

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

bool

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

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

Параметры

Closure $callback
int $attempts

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

mixed

Исключения

Throwable

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

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

Параметры

Throwable $e
int $currentAttempt
int $maxAttempts

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

void

Исключения

Throwable

void beginTransaction()

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

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

void

Исключения

Throwable

protected void createTransaction()

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

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

void

Исключения

Throwable

protected void createSavepoint()

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

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

void

Исключения

Throwable

protected void handleBeginTransactionException(Throwable $e)

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

Параметры

Throwable $e

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

void

Исключения

Throwable

void commit()

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

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

void

Исключения

Throwable

protected bool afterCommitCallbacksShouldBeExecuted()

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

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

bool

protected void handleCommitTransactionException(Throwable $e, int $currentAttempt, int $maxAttempts)

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

Параметры

Throwable $e
int $currentAttempt
int $maxAttempts

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

void

Исключения

Throwable

void rollBack(int|null $toLevel = null)

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

Параметры

int|null $toLevel

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

void

Исключения

Throwable

protected void performRollBack(int $toLevel)

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

Параметры

int $toLevel

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

void

Исключения

Throwable

protected void handleRollBackException(Throwable $e)

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

Parameters

Throwable $e

Return Value

void

Exceptions

Throwable

int transactionLevel()

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

Return Value

int

void afterCommit(callable $callback)

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

Parameters

callable $callback

Return Value

void

Exceptions

RuntimeException

protected int secondsUntil(DateTimeInterface|DateInterval|int $delay)

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

Parameters

DateTimeInterface|DateInterval|int $delay

Return Value

int

protected int availableAt(DateTimeInterface|DateInterval|int $delay = 0)

Получить отметку времени "доступно в" в формате Unix timestamp.

Parameters

DateTimeInterface|DateInterval|int $delay

Return Value

int

protected DateTimeInterface|int parseDateInterval(DateTimeInterface|DateInterval|int $delay)

Если заданное значение является интервалом, преобразовать его в экземпляр DateTime.

Parameters

DateTimeInterface|DateInterval|int $delay

Return Value

DateTimeInterface|int

protected int currentTime()

Получить текущее системное время в формате Unix timestamp.

Return Value

int

static void macro(string $name, object|callable $macro)

Зарегистрировать пользовательский макрос.

Parameters

string $name
object|callable $macro

Return Value

void

static void mixin(object $mixin, bool $replace = true)

Смешать другой объект в класс.

Parameters

object $mixin
bool $replace

Return Value

void

Exceptions

ReflectionException

static bool hasMacro(string $name)

Проверить, зарегистрирован ли макрос.

Parameters

string $name

Return Value

bool

static void flushMacros()

Очистить существующие макросы.

Return Value

void

static mixed __callStatic(string $method, array $parameters)

Динамически обработать вызовы к классу.

Parameters

string $method
array $parameters

Return Value

mixed

Exceptions

BadMethodCallException

mixed __call(string $method, array $parameters)

Динамически обработать вызовы к классу.

Parameters

string $method
array $parameters

Return Value

mixed

Exceptions

BadMethodCallException

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

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

Parameters

PDO|Closure $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()

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

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

void

protected Processor getDefaultPostProcessor()

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

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

Processor

Builder getSchemaBuilder()

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

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

Builder

Builder table(Closure|Builder|string $table, string|null $as = null)

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

Параметры

Closure|Builder|string $table
string|null $as

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

Builder

Builder query()

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

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

Builder

mixed selectOne(string $query, array $bindings = [], bool $useReadPdo = true)

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

Параметры

string $query
array $bindings
bool $useReadPdo

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

mixed

mixed scalar(string $query, array $bindings = [], bool $useReadPdo = true)

Выполнить запрос SELECT и вернуть первое значение первой строки.

Параметры

string $query
array $bindings
bool $useReadPdo

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

mixed

Исключения

MultipleColumnsSelectedException

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

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

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

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

Параметры

Closure $callback

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

массив

protected массив withFreshQueryLog(Closure $callback)

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

Параметры

Closure $callback

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

массив

пустое значение bindValues(PDOStatement $statement, array $bindings)

Привязать значения к их параметрам в данном операторе.

Параметры

PDOStatement $statement
массив $bindings

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

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

массив prepareBindings(array $bindings)

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

Параметры

массив $bindings

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

массив

protected смешанный тип run(string $query, array $bindings, Closure $callback)

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

Параметры

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

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

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

Исключения

QueryException

protected смешанный тип runQueryCallback(string $query, array $bindings, Closure $callback)

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

Параметры

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

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

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

Исключения

QueryException

пустое значение logQuery(string $query, array $bindings, float|null $time = null)

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

Параметры

строка $query
массив $bindings
float|null $time

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

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

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

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

Параметры

целое число $start

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

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

пустое значение whenQueryingForLongerThan(DateTimeInterface|CarbonInterval|число с плавающей точкой|целое число $threshold, callable $handler)

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

Параметры

DateTimeInterface|CarbonInterval|число с плавающей точкой|целое число $threshold
вызываемый объект $handler

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

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

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

Разрешить повторное выполнение всех обработчиков длительности запросов, даже если они уже выполнялись.

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

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

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

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

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

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

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

Сбросить длительность всех выполненных запросов.

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

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

protected смешанный тип handleQueryException(QueryException $e, string $query, array $bindings, Closure $callback)

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

Параметры

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

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

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

Исключения

QueryException

protected смешанный тип tryAgainIfCausedByLostConnection(QueryException $e, string $query, array $bindings, Closure $callback)

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

Параметры

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

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

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

Исключения

QueryException

смешанный тип|ложь reconnect()

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

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

смешанный тип|ложь

Исключения

LostConnectionException

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

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

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

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

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

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

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

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

$this beforeExecuting(Closure $callback)

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

Parameters

Closure $callback

Return Value

$this

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)

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

Parameters

mixed $value

Return Value

Expression

bool hasModifiedRecords()

Определить, изменил ли объект базы данных какие-либо записи в базе данных.

Return Value

bool

void recordsHaveBeenModified(bool $value = true)

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

Parameters

bool $value

Return Value

void

$this setRecordModificationState(bool $value)

Установить состояние изменения записи.

Parameters

bool $value

Return Value

$this

void forgetRecordModificationState()

Сбросить состояние изменения записи.

Return Value

void

$this useWriteConnectionWhenReading(bool $value = true)

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

Parameters

bool $value

Return Value

$this

bool isDoctrineAvailable()

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

Return Value

bool

bool usingNativeSchemaOperations()

Указывает, будут ли использоваться родные операции изменения схемы при удалении или переименовании столбцов, даже если Doctrine DBAL установлен.

Return Value

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

void registerDoctrineType(Type|string $class, string $name, string $type)

Зарегистрировать пользовательский тип сопоставления Doctrine.

Parameters

Type|string $class
string $name
string $type

Return Value

void

Exceptions

DBALException
RuntimeException

PDO getPdo()

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

Return Value

PDO

PDO|Closure|null getRawPdo()

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

Return Value

PDO|Closure|null

PDO getReadPdo()

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

Return Value

PDO

PDO|Closure|null getRawReadPdo()

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

Return Value

PDO|Closure|null

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

Установить соединение PDO.

Parameters

PDO|Closure|null $pdo

Return Value

$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

string|null getNameWithReadWriteType()

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

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

string|null

mixed getConfig(string|null $option = null)

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

Параметры

string|null $option

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

mixed

string getDriverName()

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

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

string

Grammar getQueryGrammar()

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

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

Grammar

$this setQueryGrammar(Grammar $grammar)

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

Параметры

Grammar $grammar

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

$this

Grammar getSchemaGrammar()

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

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

Grammar

$this setSchemaGrammar(Grammar $grammar)

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

Параметры

Grammar $grammar

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

$this

Processor getPostProcessor()

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

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

Processor

$this setPostProcessor(Processor $processor)

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

Параметры

Processor $processor

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

$this

Dispatcher getEventDispatcher()

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

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

Dispatcher

$this setEventDispatcher(Dispatcher $events)

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

Параметры

Dispatcher $events

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

$this

void unsetEventDispatcher()

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

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

void

$this setTransactionManager(DatabaseTransactionsManager $manager)

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

Параметры

DatabaseTransactionsManager $manager

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

$this

void unsetTransactionManager()

Удалить менеджер транзакций для этого подключения.

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

void

bool pretending()

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

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

bool

array getQueryLog()

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

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

array

void flushQueryLog()

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

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

void

void enableQueryLog()

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

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

void

void disableQueryLog()

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

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

void

bool logging()

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

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

bool

строка getDatabaseName()

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

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

строка

$this setDatabaseName(строка $database)

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

Параметры

строка $database

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

$this

$this setReadWriteType(строка|null $readWriteType)

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

Параметры

строка|null $readWriteType

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

$this

строка getTablePrefix()

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

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

строка

$this setTablePrefix(строка $prefix)

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

Параметры

строка $prefix

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

$this

Grammar withTablePrefix(Grammar $grammar)

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

Параметры

Grammar $grammar

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

Grammar

static пусто resolverFor(строка $driver, Closure $callback)

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

Параметры

строка $driver
Closure $callback

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

пусто

static смешанный тип getResolver(строка $driver)

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

Параметры

строка $driver

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

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

PostgresSchemaState getSchemaState(Filesystem $files = null, callable $processFactory = null)

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

Параметры

Filesystem $files
callable $processFactory

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

PostgresSchemaState

protected PostgresDriver getDoctrineDriver()

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

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

PostgresDriver

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API