Класс Postgres
Класс Postgres
- Cake\Database\Driver implements Cake\Database\DriverInterface
-
Cake\Database\Driver\Postgres использует Cake\Database\Dialect\PostgresDialectTrait
Краткое описание свойств
-
$_baseConfigprotectedОсновные параметры конфигурации для драйвера Postgresarray
Унаследованные свойства
-
_autoQuoting,_config,_connection_endQuote,_schemaDialect,_startQuote
Краткое описание методов
- connect() publicУстанавливает соединение с сервером базы данных
- enabled() publicВозвращает, может ли php использовать этот драйвер для подключения к базе данных
- setEncoding() publicУстанавливает кодировку соединения
- setSchema() public
Устанавливает схему по умолчанию для подключения. Если какое-либо отношение, определённое в запросе, не является полностью квалифицированным, PostgreSQL обратится к определённой схеме по умолчанию.
- supportsDynamicConstraints() public
Возвращает, поддерживает ли драйвер добавление или удаление ограничений к уже созданным таблицам.
Подробное описание методов
connect()source public
connect( )
Устанавливает соединение с сервером базы данных
Возвращает
booleantrue при успехе
enabled()source public
enabled( )
Возвращает, может ли php использовать этот драйвер для подключения к базе данных
Возвращает
booleantrue, если использование драйвера допустимо
setEncoding()source public
setEncoding( string $encoding )
Устанавливает кодировку соединения
Параметры
- строка
$encoding - Используемая кодировка.
setSchema()source public
setSchema( string $schema )
Устанавливает схему по умолчанию для подключения. Если какое-либо отношение, определённое в запросе, не является полностью квалифицированным, PostgreSQL обратится к определённой схеме по умолчанию
Параметры
- строка
$schema - Имена схем, которые нужно установить
search_path.
supportsDynamicConstraints()source public
supportsDynamicConstraints( )
Возвращает, поддерживает ли драйвер добавление или удаление ограничений к уже созданным таблицам.
Возвращает
booleantrue, если драйвер поддерживает динамические ограничения.
Наследуемые методы из Cake\Database\Driver
__construct()source public
__construct( array $config = [] )
Конструктор
Параметры
- массив
$configнеобязательно [] - Конфигурация для драйвера.
Исключение
InvalidArgumentException__debugInfo()source public
__debugInfo( )
Возвращает массив, который может быть использован для описания внутреннего состояния этого объекта.
Возвращает
массив_connect()source protected
_connect( string $dsn , array $config )
Устанавливает соединение с сервером базы данных
Параметры
- строка
$dsn - Спецификация PDO-DSN, специфичная для драйвера
- массив
$config - конфигурация, которая будет использована для создания соединения
Возвращает
booleantrue при успехе
autoQuoting()source public deprecated
autoQuoting( boolean|null $enable = null )
Возвращает, нужно ли автоматически заключать идентификаторы в запросах
Если вызван с логическим аргументом, он переключит авто-цитирование на переданное значение
Устарело
3.4.0 используйте enableAutoQuoting()/isAutoQuotingEnabled() вместо этого.Параметры
- boolean|null
$enableнеобязательно null - Включить авто-цитирование
Возвращает
booleanbeginTransaction()source public
beginTransaction( )
Начинает транзакцию.
Возвращает
booleanTrue при успехе, false в противном случае.
Реализация
Cake\Database\DriverInterface::beginTransaction() commitTransaction()source public
commitTransaction( )
Подтверждает транзакцию.
Возвращает
booleanTrue при успехе, false в противном случае.
Реализация
Cake\Database\DriverInterface::commitTransaction() compileQuery()source public
compileQuery( Cake\Database\Query $query , Cake\Database\ValueBinder $generator )
Преобразует переданный запрос в диалект этого драйвера и возвращает экземпляр преобразованного запроса и полную скомпилированную строку SQL.
Параметры
-
Cake\Database\Query$query - Запрос для компиляции.
- Cake\Database\ValueBinder
$generator - Используемый связыватель значений.
Возвращает
массивсодержащий 2 элемента. Первый элемент — преобразованный запрос, а второй — скомпилированный SQL.
Реализация
Cake\Database\DriverInterface::compileQuery() connection()source public deprecated
connection( mixed $connection = null )
Возвращает правильный ресурс или объект соединения, который используется внутри. Если первый аргумент передан, он установит внутренний объект соединения или результат в переданное значение.
Устарело
3.6.0 Используйте getConnection()/setConnection() вместо этого.Параметры
- смешанный
$connectionнеобязательно null - Экземпляр соединения PDO.
Возвращает
смешанныйВнутренний объект соединения.
disableAutoQuoting()source public
disableAutoQuoting( )
Отключает авто-цитирование идентификаторов в запросах.
Возвращает
$this
disableForeignKeySQL()source abstract public
disableForeignKeySQL( )
Получает SQL для отключения внешних ключей.
Возвращает
строкаРеализация
Cake\Database\DriverInterface::disableForeignKeySQL() disconnect()source public
disconnect( )
Отключается от сервера базы данных.
Реализация
Cake\Database\DriverInterface::disconnect() enableAutoQuoting()source public
enableAutoQuoting( boolean $enable = true )
Устанавливает, следует ли этому драйверу автоматически заключать идентификаторы в запросы.
Параметры
- boolean
$enableнеобязательно true - Включить автоматическое заключение в кавычки
Возвращает
$this
Реализация
Cake\Database\DriverInterface::enableAutoQuoting() enableForeignKeySQL()source abstract public
enableForeignKeySQL( )
Возвращает SQL для включения внешних ключей.
Возвращает
stringРеализация
Cake\Database\DriverInterface::enableForeignKeySQL() getConnection()source public
getConnection( )
Получает внутренний экземпляр соединения PDO.
Возвращает
PDOРеализация
Cake\Database\DriverInterface::getConnection() isAutoQuotingEnabled()source public
isAutoQuotingEnabled( )
Возвращает, следует ли этому драйверу автоматически заключать идентификаторы в запросы.
Возвращает
booleanРеализация
Cake\Database\DriverInterface::isAutoQuotingEnabled() isConnected()source public
isConnected( )
Проверяет, подключен ли драйвер.
Возвращает
booleanРеализация
Cake\Database\DriverInterface::isConnected() lastInsertId()source public
lastInsertId( string|null $table = null , string|null $column = null )
Возвращает последний сгенерированный идентификатор для таблицы или последовательности в базе данных.
Параметры
- string|null
$tableнеобязательно null - Имя таблицы или последовательности для получения последнего значения вставки.
- string|null
$columnнеобязательно null - Имя столбца, представляющего первичный ключ.
Возвращает
string|integerРеализация
Cake\Database\DriverInterface::lastInsertId() newCompiler()source public
newCompiler( )
Возвращает экземпляр QueryCompiler.
Возвращает
Cake\Database\QueryCompilerРеализация
Cake\Database\DriverInterface::newCompiler() prepare()source public
prepare( string|Cake\Database\Query $query )
Подготавливает SQL-запрос для выполнения.
Параметры
- string|
Cake\Database\Query$query - Запрос, который нужно преобразовать в подготовленный запрос.
Возвращает
Cake\Database\StatementInterfaceРеализация
Cake\Database\DriverInterface::prepare() queryTranslator()source abstract public
queryTranslator( string $type )
Возвращает вызываемую функцию, которая будет использоваться для преобразования переданного объекта Query. Эта функция, в свою очередь, вернёт экземпляр объекта Query, преобразованного для адаптации к особенностям используемого диалекта SQL.
Параметры
- string
$type Тип запроса, который нужно преобразовать (select, insert, update, delete).
Возвращает
callableРеализация
Cake\Database\DriverInterface::queryTranslator() quote()source public
quote( mixed $value , string $type )
Возвращает значение в безопасном представлении для использования в строке запроса
Параметры
- mixed
$value - Значение, которое нужно заключить в кавычки.
- string
$type - Тип, который будет использоваться для определения вида заключения в кавычки.
Возвращает
stringРеализация
Cake\Database\DriverInterface::quote() quoteIdentifier()source abstract public
quoteIdentifier( string $identifier )
Заключает базовый идентификатор (имя столбца, имя таблицы и т.д.) в кавычки для безопасного использования в запросах, исключая риск использования зарезервированных слов.
Параметры
- string
$identifier - Выражение идентификатора для заключения в кавычки.
Возвращает
stringРеализация
Cake\Database\DriverInterface::quoteIdentifier() releaseSavePointSQL()source abstract public
releaseSavePointSQL( string $name )
Возвращает SQL для освобождения точки сохранения.
Параметры
- string
$name - Имя таблицы.
Возвращает
stringРеализация
Cake\Database\DriverInterface::releaseSavePointSQL() rollbackSavePointSQL()source abstract public
rollbackSavePointSQL( string $name )
Возвращает SQL для отката точки сохранения.
Параметры
- string
$name - Имя таблицы.
Возвращает
stringРеализация
Cake\Database\DriverInterface::rollbackSavePointSQL() rollbackTransaction()source public
rollbackTransaction( )
Откатывает транзакцию.
Возвращает
booleanУспешно — true, в противном случае — false.
Реализация
Cake\Database\DriverInterface::rollbackTransaction() savePointSQL()source abstract public
savePointSQL( string $name )
Возвращает SQL для создания точки сохранения.
Параметры
- string
$name - Имя таблицы.
Возвращает
stringРеализация
Cake\Database\DriverInterface::savePointSQL() schema()source public
schema( )
Возвращает имя схемы, которое используется.
Возвращает
stringРеализация
Cake\Database\DriverInterface::schema() schemaDialect()source abstract public
schemaDialect( )
Возвращает диалект схемы.
Возвращает
Cake\Database\Schema\BaseSchemaРеализация
Cake\Database\DriverInterface::schemaDialect() schemaValue()source public
schemaValue( mixed $value )
Экранирует значения для использования в определениях схемы.
Параметры
- mixed
$value - Значение, которое нужно экранировать.
Возвращает
stringСтрока для использования в определениях схемы.
Реализация
Cake\Database\DriverInterface::schemaValue() setConnection()source public
setConnection( PDO $connection )
Устанавливает внутренний экземпляр соединения PDO.
Параметры
- PDO
$connection - Экземпляр PDO.
Возвращает
$this
Реализация
Cake\Database\DriverInterface::setConnection() supportsQuoting()source public
supportsQuoting( )
Проверяет, поддерживает ли драйвер цитирование, так как PDO_ODBC его не поддерживает.
Возвращает
booleanРеализация
Cake\Database\DriverInterface::supportsQuoting() supportsSavePoints()source public
supportsSavePoints( )
Возвращает, поддерживает ли этот драйвер сохраняемые точки для вложенных транзакций.
Возвращает
booleanTrue, если сохраняемые точки поддерживаются, иначе false.
Реализация
Cake\Database\DriverInterface::supportsSavePoints() Методы, используемые из Cake\Database\Dialect\PostgresDialectTrait
_expressionTranslators()source protected
_expressionTranslators( )
Возвращает словарь выражений, которые должны быть преобразованы при компиляции запроса в SQL. Ключи массива — имена методов, которые следует вызывать в этом классе.
Возвращает
array_insertQueryTranslator()source protected
_insertQueryTranslator( Cake\Database\Query $query )
Изменяет исходный запрос вставки, добавляя эпилог «RETURNING *», чтобы можно было получить последний идентификатор вставки.
Параметры
- Cake\Database\Query
$query - Запрос для преобразования.
Возвращает
Cake\Database\Query_transformDistinct()source protected
_transformDistinct( Cake\Database\Query $query )
Оператор DISTINCT не требует преобразования.
Параметры
- Cake\Database\Query
$query - Запрос, который нужно преобразовать.
Возвращает
Cake\Database\Query_transformFunctionExpression()source protected
_transformFunctionExpression( Cake\Database\Expression\FunctionExpression $expression )
Получает FunctionExpression и изменяет его так, чтобы он соответствовал этому диалекту SQL.
Параметры
- Cake\Database\Expression\FunctionExpression
$expression Выражение функции, подлежащее преобразованию в SQL Postgres.
disableForeignKeySQL()source public
disableForeignKeySQL( )
enableForeignKeySQL()source public
enableForeignKeySQL( )
schemaDialect()source public
schemaDialect( )
Получение диалекта схемы.
Используется пакетом Cake\Database\Schema для отражения схемы и генерации схемы.
Возвращает
Cake\Database\Schema\PostgresSchemaПодробности свойств
$_baseConfigsource
protected array
Основные параметры конфигурации для драйвера Postgres
[
'persistent' => true,
'host' => 'localhost',
'username' => 'root',
'password' => '',
'database' => 'cake',
'schema' => 'public',
'port' => 5432,
'encoding' => 'utf8',
'timezone' => null,
'flags' => [],
'init' => [],
]
© 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/3.7/class-Cake.Database.Driver.Postgres.html