Класс Postgres

Пространство имен: Cake\Database\Driver

Константы

int|null

MAX_ALIAS_LENGTH
```
63
```
int[]

RETRY_ERROR_CODES
```
[]
```

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

$_autoQuoting protected

bool

Указывает, выполняет ли драйвер автоматическое цитирование идентификаторов для всех запросов
$_baseConfig protected

array

Базовые параметры конфигурации для драйвера Postgres
$_config protected

array

Данные конфигурации.
$_connection protected

PDO

Экземпляр PDO.
$_endQuote protected

string

Строка, используемая для завершения цитирования идентификатора базы данных для обеспечения безопасности
$_schemaDialect protected

Cake\Database\Schema\PostgresSchemaDialect|null

Класс диалекта схемы для этого драйвера
$_startQuote protected

string

Строка, используемая для начала цитирования идентификатора базы данных для обеспечения безопасности
$_version protected

string|null

Версия сервера
$connectRetries protected

int

Последнее количество попыток повторного подключения.
$supportsCTEs protected

bool|null

Поддерживает ли сервер выражения общих таблиц.

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

__construct() public

Конструктор
__debugInfo() public

Возвращает массив, который можно использовать для описания внутреннего состояния этого объекта.
__destruct() public

Деструктор
_connect() protected

Устанавливает соединение с сервером базы данных
_deleteQueryTranslator() protected

Применяет шаги перевода к запросам удаления.
_expressionTranslators() protected

Возвращает ассоциативный массив методов, которые будут преобразовывать объекты Expression для соответствия конкретному диалекту SQL. Ключи — имена классов, значения — метод в этом классе.
_insertQueryTranslator() protected

Применяет шаги перевода к запросам вставки.
_removeAliasesFromConditions() protected

Удаляет псевдонимы из WHERE фрагмента запроса.
_selectQueryTranslator() protected

Применяет шаги перевода к запросам выбора.
_transformDistinct() protected

Возвращает переданный запрос после переработки фрагмента DISTINCT, чтобы драйверы, не поддерживающие часть "ON", могли предоставить фактический способ его выполнения.
_transformFunctionExpression() protected

Принимает FunctionExpression и изменяет его так, чтобы он соответствовал этому диалекту SQL.
_transformIdentifierExpression() protected

Преобразует выражение идентификатора в формат PostgreSQL.
_transformStringExpression() protected

Преобразует строковое выражение в формат PostgreSQL.
_updateQueryTranslator() protected

Применяет шаги перевода к запросам обновления.
beginTransaction() public

Начинает транзакцию.
commitTransaction() public

Подтверждает транзакцию.
compileQuery() public

Преобразует переданный запрос в диалект этого драйвера и возвращает экземпляр преобразованного запроса и полную скомпилированную строку SQL.
connect() public

Устанавливает соединение с сервером базы данных
disableAutoQuoting() public

Отключает автоматическое присвоение кавычек идентификаторам в запросах.
disableForeignKeySQL() public

Возвращает SQL для отключения внешних ключей.
disconnect() public

Отключается от сервера базы данных.
enableAutoQuoting() public

Устанавливает, следует ли этому драйверу автоматически присваивать кавычки идентификаторам в запросах.
enableForeignKeySQL() public

Возвращает SQL для включения внешних ключей.
enabled() public

Возвращает, может ли php использовать этот драйвер для подключения к базе данных.
getConnectRetries() public

Возвращает количество попыток повторного подключения.
getConnection() public

Получает внутренний экземпляр подключения PDO.
getMaxAliasLength() public

Возвращает максимальную длину псевдонима. Она может отличаться от максимальной длины идентификатора столбцов.
isAutoQuotingEnabled() public

Возвращает, следует ли этому драйверу автоматически присваивать кавычки идентификаторам в запросах.
isConnected() public

Проверяет, подключен ли драйвер.
lastInsertId() public

Возвращает последний сгенерированный идентификатор для таблицы или последовательности в базе данных.
newCompiler() public

Возвращает экземпляр QueryCompiler.
newTableSchema() public

Создаёт новый TableSchema.
prepare() public

Подготавливает sql-запрос для выполнения.
queryTranslator() public

Возвращает вызываемую функцию, которая будет использоваться для преобразования переданного объекта Query. Эта функция, в свою очередь, вернёт экземпляр объекта Query, который был преобразован для соответствия особенностям используемого диалекта SQL.
quote() public

Возвращает значение в безопасном представлении для использования в строке запроса.
quoteIdentifier() public

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

Возвращает фрагмент SQL для освобождения ранее созданной точки сохранения.
rollbackSavePointSQL() public

Возвращает фрагмент SQL для отката ранее созданной точки сохранения.
rollbackTransaction() public

Отменяет транзакцию.
savePointSQL() public

Возвращает фрагмент SQL для создания новой точки сохранения транзакции.
schema() public

Возвращает имя схемы, которое используется.
schemaDialect() public

Получает диалект схемы.
schemaValue() public

Экранирует значения для использования в определениях схемы.
setConnection() public

Устанавливает внутренний экземпляр подключения PDO.
setEncoding() public

Устанавливает кодировку подключения

setSchema() public

Устанавливает схему по умолчанию для подключения, если в запросе определено отношение, которое не полностью квалифицировано, PostgreSQL будет искать это отношение в заданной схеме по умолчанию.
supportsCTEs() public

Возвращает true, если сервер поддерживает выражения с общими таблицами.
supportsDynamicConstraints() public

Возвращает, поддерживает ли драйвер добавление или удаление ограничений к уже созданным таблицам.
supportsQuoting() public

Проверяет, поддерживает ли драйвер цитирование, так как PDO_ODBC его не поддерживает.
supportsSavePoints() public

Возвращает, поддерживает ли этот драйвер точки сохранения для вложенных транзакций.
version() public

Возвращает версию подключенного сервера.

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

__construct() public

__construct(array $config = [])

Конструктор

Параметры

array $config необязательный: Настройка драйвера.

Исключения

InvalidArgumentException

__debugInfo() public

__debugInfo(): array

Возвращает массив, который можно использовать для описания внутреннего состояния этого объекта.

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

array

__destruct() public

__destruct()

Деструктор

_connect() protected

_connect(string $dsn, array $config): bool

Устанавливает соединение с сервером базы данных

Параметры

string $dsn: Спецификатор источника данных (DSN) PDO, специфичный для драйвера.
array $config: настройки, используемые для создания подключения

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

bool

_deleteQueryTranslator() protected

_deleteQueryTranslator(Cake\Database\Query $query): Cake\Database\Query

Применяет шаги трансляции к запросам удаления.

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

Мы намеренно не поддерживаем удаления с объединениями, так как они имеют еще худшую поддержку.

Параметры

Cake\Database\Query $query: Запрос для трансляции

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

Cake\Database\Query

_expressionTranslators() protected

_expressionTranslators(): string[]

Возвращает ассоциативный массив методов, которые преобразуют объекты Expression для соответствия конкретному диалекту SQL. Ключи — имена классов, значения — метод в этом классе.

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

string[]

_insertQueryTranslator() protected

_insertQueryTranslator(Cake\Database\Query $query): Cake\Database\Query

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

Параметры

Cake\Database\Query $query

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

Cake\Database\Query

_removeAliasesFromConditions() protected

_removeAliasesFromConditions(Cake\Database\Query $query): Cake\Database\Query

Удаляет псевдонимы из условия WHERE запроса.

Параметры

Cake\Database\Query $query: Запрос для обработки.

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

Cake\Database\Query

Исключения

RuntimeException
В случае, если обработанный запрос содержит объединения, так как удаление псевдонимов из условий может нарушить ссылки на соединённые таблицы.

_selectQueryTranslator() protected

_selectQueryTranslator(Cake\Database\Query $query): Cake\Database\Query

Применяет шаги трансляции к запросам выбора.

Параметры

Cake\Database\Query $query: Запрос для трансляции

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

Cake\Database\Query

_transformDistinct() protected

_transformDistinct(Cake\Database\Query $query): Cake\Database\Query

Возвращает переданный запрос после переработки условия DISTINCT, чтобы драйверы, которые не поддерживают часть «ON», могли предоставить фактический способ её реализации.

Параметры

Cake\Database\Query $query

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

Cake\Database\Query

_transformFunctionExpression() protected

_transformFunctionExpression(Cake\Database\Expression\FunctionExpression $expression): void

Принимает FunctionExpression и изменяет его так, чтобы он соответствовал данному диалекту SQL.

Параметры

Cake\Database\Expression\FunctionExpression $expression: Функциональное выражение для преобразования в SQL Postgres.

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

void

_transformIdentifierExpression() protected

_transformIdentifierExpression(Cake\Database\Expression\IdentifierExpression $expression): void

Преобразует выражение идентификатора в формат PostgreSQL.

Параметры

Cake\Database\Expression\IdentifierExpression $expression: Выражение для преобразования.

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

void

_transformStringExpression() protected

_transformStringExpression(Cake\Database\Expression\StringExpression $expression): void

Преобразует строковое выражение в формат PostgreSQL.

Параметры

Cake\Database\Expression\StringExpression $expression: Строковое выражение для преобразования.

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

void

_updateQueryTranslator() protected

_updateQueryTranslator(Cake\Database\Query $query): Cake\Database\Query

Применяет шаги трансляции к запросам обновления.

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

Также, как и для запросов удаления, объединения в настоящее время не поддерживаются для запросов обновления.

Параметры

Cake\Database\Query $query: Запрос для трансляции

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

Cake\Database\Query

beginTransaction() public

beginTransaction(): bool

Начинает транзакцию.

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

bool

commitTransaction() public

commitTransaction(): bool

Подтверждает транзакцию.

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

bool

compileQuery() public

compileQuery(Cake\Database\Query $query, Cake\Database\ValueBinder $binder): array

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

Параметры

Cake\Database\Query $query
Cake\Database\ValueBinder $binder

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

array

connect() public

connect(): bool

Устанавливает соединение с сервером базы данных

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

bool

disableAutoQuoting() public

disableAutoQuoting(): $this

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

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

$this

disableForeignKeySQL() public

disableForeignKeySQL(): string

Получает SQL-код для отключения внешних ключей.

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

string

disconnect() public

disconnect(): void

Отключается от сервера базы данных.

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

void

enableAutoQuoting() public

enableAutoQuoting(bool $enable = true): $this

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

Параметры

bool $enable необязательный

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

$this

enableForeignKeySQL() public

enableForeignKeySQL(): string

Получает SQL-код для включения внешних ключей.

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

string

enabled() public

enabled(): bool

Возвращает, может ли php использовать этот драйвер для подключения к базе данных

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

bool

getConnectRetries() public

getConnectRetries(): int

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

Returns

int

getConnection() public

getConnection(): PDO

Получает внутренний экземпляр PDO-подключения.

Returns

PDO

getMaxAliasLength() public

getMaxAliasLength(): int|null

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

Returns

int|null

isAutoQuotingEnabled() public

isAutoQuotingEnabled(): bool

Возвращает, должен ли этот драйвер автоматически заключать идентификаторы в кавычки в запросах.

Returns

bool

isConnected() public

isConnected(): bool

Проверяет, подключен ли драйвер.

Returns

bool

lastInsertId() public

lastInsertId(string|null $table = null, string|null $column = null): string|int

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

Parameters

string|null $table optional
string|null $column optional

Returns

string|int

newCompiler() public

newCompiler(): Cake\Database\PostgresCompiler

Возвращает экземпляр QueryCompiler.

Returns

Cake\Database\PostgresCompiler

newTableSchema() public

newTableSchema(string $table, array $columns = []): Cake\Database\Schema\TableSchema

Создает новый TableSchema.

Parameters

string $table
array $columns optional

Returns

Cake\Database\Schema\TableSchema

prepare() public

prepare(stringCake\Database\Query $query): Cake\Database\StatementInterface

Подготавливает SQL-запрос к выполнению.

Parameters

stringCake\Database\Query $query

Returns

Cake\Database\StatementInterface

queryTranslator() public

queryTranslator(string $type): Closure

Возвращает вызываемую функцию, которая будет использоваться для преобразования переданного объекта Query. Эта функция, в свою очередь, вернет экземпляр объекта Query, который был преобразован для учета любых особенностей используемого SQL-диалекта.

Parameters

string $type: тип преобразуемого запроса (select, insert, update, delete)

Returns

Closure

quote() public

quote(mixed $value, int $type = PDO::PARAM_STR): string

Возвращает значение в безопасном представлении для использования в строке запроса

Parameters

mixed $value
int $type optional

Returns

string

quoteIdentifier() public

quoteIdentifier(string $identifier): string

Заключает идентификатор базы данных (имя столбца, имя таблицы и т. д.) в кавычки, чтобы безопасно использовать его в запросах без риска использования зарезервированных слов

Parameters

string $identifier: Идентификатор для заключения в кавычки.

Returns

string

releaseSavePointSQL() public

releaseSavePointSQL(string|int $name): string

Возвращает фрагмент SQL для освобождения ранее созданной точки сохранения

Parameters

string|int $name: имя точки сохранения

Returns

string

rollbackSavePointSQL() public

rollbackSavePointSQL(string|int $name): string

Возвращает фрагмент SQL для отката ранее созданной точки сохранения

Parameters

string|int $name: имя точки сохранения

Returns

string

rollbackTransaction() public

rollbackTransaction(): bool

Откатывает транзакцию.

Returns

bool

savePointSQL() public

savePointSQL(string|int $name): string

Возвращает фрагмент SQL для создания новой точки сохранения транзакции

Parameters

string|int $name: имя точки сохранения

Returns

string

schema() public

schema(): string

Возвращает используемое имя схемы.

Returns

string

schemaDialect() public

schemaDialect(): Cake\Database\Schema\SchemaDialect

Получает диалект схемы.

Используется пакетом Cake\Database\Schema для отражения схемы и генерации схемы.

Если все таблицы, использующие этот драйвер, указывают свои собственные схемы, то это может вернуть null.

Returns

Cake\Database\Schema\SchemaDialect

schemaValue() public

schemaValue(mixed $value): string

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

Parameters

mixed $value

Returns

string

setConnection() public

setConnection(object $connection): $this

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

Parameters

object $connection: Экземпляр PDO.

Returns

$this

setEncoding() public

setEncoding(string $encoding): void

Устанавливает кодировку соединения

Parameters

string $encoding: Кодировка для использования.

Returns

void

setSchema() public

setSchema(string $schema): void

Устанавливает схему по умолчанию для соединения, если какое-либо отношение, определенное в запросе, не является полностью квалифицированным, postgres будет возвращаться к поиску отношения в определенной схеме по умолчанию

Parameters

string $schema: Имена схем для установки search_path.

Returns

void

supportsCTEs() public

supportsCTEs(): bool

Возвращает true, если сервер поддерживает общие табличные выражения.

Returns

bool

supportsDynamicConstraints() public

supportsDynamicConstraints(): bool

Возвращает, поддерживает ли драйвер добавление или удаление ограничений в уже созданные таблицы.

Returns

bool

supportsQuoting() public

supportsQuoting(): bool

Проверяет, поддерживает ли драйвер кавычки, так как PDO_ODBC их не поддерживает.

Returns

bool

supportsSavePoints() public

supportsSavePoints(): bool

Возвращает, поддерживает ли этот драйвер точки сохранения для вложенных транзакций.

Returns

bool

version() public

version(): string

Возвращает версию подключенного сервера.

Возвращает

string

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

`$_autoQuoting` protected

Указывает, выполняет ли драйвер автоматическое цитирование идентификаторов для всех запросов

Тип

bool

`$_baseConfig` protected

Основные параметры конфигурации для драйвера Postgres

Тип

array

`$_config` protected

Данные конфигурации.

Тип

array

`$_connection` protected

Экземпляр PDO.

Тип

PDO

`$_endQuote` protected

Строка, используемая для завершения цитирования идентификатора базы данных для обеспечения безопасности

Тип

string

`$_schemaDialect` protected

Класс диалекта схемы для этого драйвера

Тип

Cake\Database\Schema\PostgresSchemaDialect|null

`$_startQuote` protected

Строка, используемая для начала цитирования идентификатора базы данных для обеспечения безопасности

Тип

string

`$_version` protected

Версия сервера

Тип

string|null

`$connectRetries` protected

Последнее количество попыток повторного подключения.

Тип

int

`$supportsCTEs` protected

Поддерживает ли сервер выражения общих таблиц.

Тип

bool|null

© 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.2/class-Cake.Database.Driver.Postgres.html