Spec-Zone.ru › Laravel 5.4

Подключение

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

Трейты

DetectsDeadlocks
DetectsLostConnections
ManagesTransactions

Свойства

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

Методы

bool causedByDeadlock(Exception $e)

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

из DetectsDeadlocks
bool causedByLostConnection(Exception $e)

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

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

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

из ManagesTransactions
void handleTransactionException(Exception $e, int $currentAttempt, int $maxAttempts)

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

из ManagesTransactions
void beginTransaction()

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

из ManagesTransactions
void createTransaction()

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

из ManagesTransactions
void createSavepoint()

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

из ManagesTransactions
void handleBeginTransactionException(Exception $e)

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

из ManagesTransactions
void commit()

Зафиксировать активную транзакцию базы данных.

из ManagesTransactions
void rollBack(int|null $toLevel = null)

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

из ManagesTransactions
void performRollBack(int $toLevel)

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

из ManagesTransactions
int transactionLevel()

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

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

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

void useDefaultQueryGrammar()

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

Grammar getDefaultQueryGrammar()

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

void useDefaultSchemaGrammar()

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

Grammar getDefaultSchemaGrammar()

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

void useDefaultPostProcessor()

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

Processor getDefaultPostProcessor()

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

Builder getSchemaBuilder()

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

Builder table(string $table)

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

Builder query()

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

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

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

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

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

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

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

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

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

PDOStatement prepared(PDOStatement $statement)

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

PDO getPdoForSelect(bool $useReadPdo = true)

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

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

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

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

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

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

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

bool statement(string $query, array $bindings = [])

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

int affectingStatement(string $query, array $bindings = [])

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

bool unprepared(string $query)

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

array pretend(Closure $callback)

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

array withFreshQueryLog(Closure $callback)

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

void bindValues(PDOStatement $statement, array $bindings)

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

array prepareBindings(array $bindings)

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

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

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

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

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

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

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

float getElapsedTime(int $start)

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

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

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

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

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

void reconnect()

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

void reconnectIfMissingConnection()

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

void disconnect()

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

void listen(Closure $callback)

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

array|null fireConnectionEvent(string $event)

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

void event(mixed $event)

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

Expression raw(mixed $value)

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

bool isDoctrineAvailable()

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

Column getDoctrineColumn(string $table, string $column)

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

AbstractSchemaManager getDoctrineSchemaManager()

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

Connection getDoctrineConnection()

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

PDO getPdo()

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

PDO getReadPdo()

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

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

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

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

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

$this setReconnector(callable $reconnector)

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

string|null getName()

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

mixed getConfig(string|null $option = null)

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

string getDriverName()

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

Grammar getQueryGrammar()

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

void setQueryGrammar(Grammar $grammar)

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

Grammar getSchemaGrammar()

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

void setSchemaGrammar(Grammar $grammar)

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

Processor getPostProcessor()

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

void setPostProcessor(Processor $processor)

Установить постпроцессор запросов для соединения.

Dispatcher getEventDispatcher()

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

void setEventDispatcher(Dispatcher $events)

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

bool pretending()

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

array getQueryLog()

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

void flushQueryLog()

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

void enableQueryLog()

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

void disableQueryLog()

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

bool logging()

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

string getDatabaseName()

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

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

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

строка getTablePrefix()

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

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

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

Grammar withTablePrefix(Grammar $grammar)

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

статический void resolverFor(строка $driver, Closure $callback)

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

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

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

Подробности

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

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

Параметры

Exception $e

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

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

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

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

Параметры

Exception $e

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

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

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

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

Параметры

Closure $callback
целое число $attempts

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

смешанный

Исключения

Throwable

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

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

Параметры

Exception $e
целое число $currentAttempt
целое число $maxAttempts

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

void

Исключения

Exception

void beginTransaction()

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

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

void

Исключения

Exception

protected void createTransaction()

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

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

void

protected void createSavepoint()

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

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

void

protected void handleBeginTransactionException(Exception $e)

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

Параметры

Exception $e

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

void

Исключения

Exception

void commit()

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

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

void

void rollBack(int|null $toLevel = null)

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

Параметры

int|null $toLevel

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

void

protected void performRollBack(int $toLevel)

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

Параметры

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

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

void

целое число transactionLevel()

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

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

целое число

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

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

Параметры

PDO|Closure $pdo
строка $database
строка $tablePrefix
массив $config

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

void

void useDefaultQueryGrammar()

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

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

void

protected Grammar getDefaultQueryGrammar()

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

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

Grammar

void useDefaultSchemaGrammar()

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

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

void

protected Grammar getDefaultSchemaGrammar()

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

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

Grammar

void useDefaultPostProcessor()

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

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

void

protected Processor getDefaultPostProcessor()

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

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

Processor

Builder getSchemaBuilder()

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

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

Builder

Builder table(string $table)

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

Параметры

string $table

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

Builder

Builder query()

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

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

Builder

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

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

Параметры

string $query
array $bindings
bool $useReadPdo

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

mixed

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

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

Параметры

string $query
array $bindings

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

array

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

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

Параметры

string $query
array $bindings
bool $useReadPdo

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

array

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

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

Параметры

string $query
array $bindings
bool $useReadPdo

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

Generator

protected PDOStatement prepared(PDOStatement $statement)

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

Параметры

PDOStatement $statement

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

PDOStatement

protected PDO getPdoForSelect(bool $useReadPdo = true)

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

Параметры

bool $useReadPdo

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

PDO

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

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

Параметры

string $query
array $bindings

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

bool

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

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

Параметры

string $query
array $bindings

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

int

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

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

Параметры

string $query
array $bindings

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

int

bool statement(string $query, array $bindings = [])

Выполнить SQL-запрос и вернуть булевый результат.

Параметры

string $query
array $bindings

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

bool

int affectingStatement(string $query, array $bindings = [])

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

Параметры

string $query
array $bindings

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

int

bool unprepared(string $query)

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

Параметры

string $query

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

bool

array pretend(Closure $callback)

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

Параметры

Closure $callback

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

array

protected array withFreshQueryLog(Closure $callback)

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

Параметры

Closure $callback

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

array

void bindValues(PDOStatement $statement, array $bindings)

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

Параметры

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)

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

Параметры

mixed $value

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

Expression

bool isDoctrineAvailable()

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

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

bool

Column 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|Closure|null $pdo)

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

Параметры

PDO|Closure|null $pdo

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

$this

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

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

Параметры

PDO|Closure|null $pdo

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

$this

$this setReconnector(callable $reconnector)

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

Параметры

callable $reconnector

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

$this

string|null getName()

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

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

string|null

mixed getConfig(string|null $option = null)

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

Параметры

string|null $option

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

mixed

string getDriverName()

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

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

string

Grammar getQueryGrammar()

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

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

Grammar

void setQueryGrammar(Grammar $grammar)

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

Параметры

Grammar $grammar

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

void

Grammar getSchemaGrammar()

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

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

Grammar

void setSchemaGrammar(Grammar $grammar)

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

Параметры

Grammar $grammar

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

void

Processor getPostProcessor()

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

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

Processor

void setPostProcessor(Processor $processor)

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

Параметры

Processor $processor

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

void

Dispatcher getEventDispatcher()

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

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

Dispatcher

void setEventDispatcher(Dispatcher $events)

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

Параметры

Dispatcher $events

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

void

bool pretending()

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

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

bool

array getQueryLog()

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

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

array

void flushQueryLog()

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

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

void

void enableQueryLog()

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

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

void

void disableQueryLog()

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

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

void

bool logging()

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

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

bool

string getDatabaseName()

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

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

string

string setDatabaseName(string $database)

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

Параметры

string $database

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

string

string getTablePrefix()

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

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

string

void setTablePrefix(string $prefix)

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

Параметры

string $prefix

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

void

Grammar withTablePrefix(Grammar $grammar)

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

Параметры

Grammar $grammar

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

Grammar

static void resolverFor(string $driver, Closure $callback)

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

Параметры

string $driver
Closure $callback

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

void

static mixed getResolver(string $driver)

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

Параметры

string $driver

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

mixed

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

Spec-Zone.ru

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