Интерфейс ConnectionInterface

Этот интерфейс определяет методы, на которые можно положиться при работе с подключением.

Пространство имён: Cake\Datasource

Краткое описание методов

config() public

Получить данные конфигурации, используемые для создания подключения.
configName() public

Получить имя конфигурации для этого подключения.
disableConstraints() public

Выполнить операцию с отключёнными ограничениями.
disableQueryLogging() public

Отключить протоколирование запросов
enableQueryLogging() public

Включить/выключить протоколирование запросов
execute() public @method

Выполняет запрос, используя $params для интерполяции значений и $types в качестве подсказки для каждого из этих параметров. {@see \Cake\Database\Connnection::execute()}
getCacher() public

Получить кешер.
getDriver() public @method

Получить экземпляр драйвера. {@see \Cake\Database\Connnection::getDriver()}
getLogger() public

Получить текущий объект логгера.
getSchemaCollection() public @method

Получить объект Schema\Collection для этого подключения. {@see \Cake\Database\Connnection::getSchemaCollection()}
isQueryLoggingEnabled() public

Проверить, включено ли протоколирование запросов.
newQuery() public @method

Создать новый экземпляр Query для этого подключения. {@see \Cake\Database\Connnection::newQuery()}
prepare() public @method

Подготовить SQL-запрос для выполнения. {@see \Cake\Database\Connnection::prepare()}
query() public @method

Выполняет SQL-запрос и возвращает объект Statement в качестве результата. {@see \Cake\Database\Connnection::query()}
setCacher() public

Установить кешер.
setLogger() public @method

Установить текущий логгер. {@see \Cake\Database\Connnection::setLogger()}
supportsDynamicConstraints() public @method

Возвращает, поддерживает ли драйвер добавление или удаление ограничений для уже созданных таблиц. {@see \Cake\Database\Connnection::supportsDynamicConstraints()}
transactional() public

Выполняет функцию callable внутри транзакции. Если при выполнении переданной callable функции возникает исключение, транзакция будет отменена. Если результатом callable функции является false, транзакция также будет отменена. В противном случае транзакция подтверждается после выполнения обратного вызова.

Подробное описание методов

config() public

config(): array

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

Возвращает

array

configName() public

configName(): string

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

Возвращает

string

disableConstraints() public

disableConstraints(callable $callback): mixed

Выполнить операцию с отключенными ограничениями.

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

Пример:

$connection->disableConstraints(function ($connection) {
  $connection->newQuery()->delete('users')->execute();
});

Параметры

callable $callback: Обратный вызов для выполнения транзакции.

Возвращает

mixed

Исключения

Exception
Будет повторно выброшено любое исключение, поднятое в $callback после отката транзакции.

disableQueryLogging() public

disableQueryLogging(): $this

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

Возвращает

$this

enableQueryLogging() public

enableQueryLogging(bool $enable = true): $this

Включить/выключить протоколирование запросов

Параметры

bool $enable optional: Включить/выключить протоколирование запросов

Возвращает

$this

execute() public @method

execute(mixed $query, mixed $params = [], array $types = []): Cake\Database\StatementInterface

Выполняет запрос, используя $params для интерполяции значений и $types как подсказку для каждого из этих параметров. {@see \Cake\Database\Connnection::execute()}

Параметры

$query
$params optional
array $types optional

Возвращает

Cake\Database\StatementInterface

getCacher() public

getCacher(): Psr\SimpleCache\CacheInterface

Получить кешер.

Возвращает

Psr\SimpleCache\CacheInterface

getDriver() public @method

getDriver(): object

Получить экземпляр драйвера. {@see \Cake\Database\Connnection::getDriver()}

Возвращает

object

getLogger() public

getLogger(): Psr\Log\LoggerInterface

Получить текущий объект логгера.

Возвращает

Psr\Log\LoggerInterface

getSchemaCollection() public @method

getSchemaCollection(): Cake\Database\Schema\Collection

Получить объект Schema\Collection для этого подключения. {@see \Cake\Database\Connnection::getSchemaCollection()}

Возвращает

Cake\Database\Schema\Collection

isQueryLoggingEnabled() public

isQueryLoggingEnabled(): bool

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

Возвращает

bool

newQuery() public @method

newQuery(): Cake\Database\Query

Создать новый экземпляр Query для этого подключения. {@see \Cake\Database\Connnection::newQuery()}

Возвращает

Cake\Database\Query

prepare() public @method

prepare(mixed $sql): Cake\Database\StatementInterface

Подготовить SQL-запрос для выполнения. {@see \Cake\Database\Connnection::prepare()}

Параметры

$sql

Возвращает

Cake\Database\StatementInterface

query() public @method

query(string $sql): Cake\Database\StatementInterface

Выполняет SQL-запрос и возвращает объект Statement в качестве результата. {@see \Cake\Database\Connnection::query()}

Параметры

string $sql

Возвращает

Cake\Database\StatementInterface

setCacher() public

setCacher(Psr\SimpleCache\CacheInterface $cacher): $this

Установить кешер.

Параметры

Psr\SimpleCache\CacheInterface $cacher: Объект кэшера

Возвращает

$this

setLogger() public @method

setLogger(LoggerInterface $logger): void

Установить текущий логгер. {@see \Cake\Database\Connnection::setLogger()}

Параметры

LoggerInterface $logger

Возвращает

void

supportsDynamicConstraints() public @method

supportsDynamicConstraints(): bool

Возвращает, поддерживает ли драйвер добавление или удаление ограничений к уже созданным таблицам. {@see \Cake\Database\Connnection::supportsDynamicConstraints()}

Возвращает

bool

transactional() public

transactional(callable $callback): mixed

Выполняет функцию обратного вызова внутри транзакции. Если во время выполнения переданного обратного вызова возникнет какое-либо исключение, транзакция будет откатана. Если результатом функции обратного вызова является false, транзакция также будет откатана. В противном случае транзакция подтверждается после выполнения обратного вызова.

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

Пример:

$connection->transactional(function ($connection) {
  $connection->newQuery()->delete('users')->execute();
});

Параметры

callable $callback: Обратный вызов для выполнения внутри транзакции.

Возвращает

mixed

Исключения

Exception
Будет повторно выброшено любое исключение, поднятое в $callback после отката транзакции.

© 2005–present The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/4.3/interface-Cake.Datasource.ConnectionInterface.html