Spec-Zone.ru › CakePHP 3.3

Класс Driver

Представляет драйвер базы данных, содержащий все особенности движка базы данных, включая его диалект SQL.

Прямые подклассы

  • Cake\Database\Driver\Mysql
  • Cake\Database\Driver\Postgres
  • Cake\Database\Driver\Sqlite
  • Cake\Database\Driver\Sqlserver
Абстрактный
Пространство имён: Cake\Database
Расположение: Database/Driver.php

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

  • $_autoQuoting protected
    boolean

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

  • $_baseConfig protected
    array

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

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

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

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

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

  • __destruct() public
    Деструктор
  • autoQuoting() public

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

  • beginTransaction() abstract public
    Начинает транзакцию
  • commitTransaction() abstract public
    Завершает транзакцию
  • compileQuery() public

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

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

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

  • disableForeignKeySQL() abstract public
    Получает SQL для отключения внешних ключей
  • disconnect() abstract public
    Отключается от сервера базы данных
  • enableForeignKeySQL() abstract public
    Получает SQL для включения внешних ключей
  • enabled() abstract public
    Возвращает, может ли php использовать этот драйвер для подключения к базе данных
  • isConnected() public
    Проверяет, подключен ли драйвер.
  • lastInsertId() public
    Возвращает последний сгенерированный идентификатор для таблицы или последовательности в базе данных
  • newCompiler() public
    Возвращает экземпляр QueryCompiler
  • prepare() abstract public
    Подготавливает sql-запрос для выполнения
  • queryTranslator() abstract public

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

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

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

  • releaseSavePointSQL() abstract public
    Получает SQL для высвобождения точки сохранения.
  • rollbackSavePointSQL() abstract public
    Получает SQL для отката точки сохранения.
  • rollbackTransaction() abstract public
    Откатывает транзакцию
  • savePointSQL() abstract public
    Получает SQL для создания точки сохранения.
  • schema() public
    Возвращает имя схемы, используемой в данный момент
  • schemaDialect() abstract public
    Получает диалект схемы.
  • schemaValue() public
    Использует значения для экранирования в определениях схем.
  • supportsDynamicConstraints() abstract public

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

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

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

__construct()source public

__construct( array $config [] )

Конструктор

Параметры

array $config необязательно []
Конфигурация драйвера.

Исключения

InvalidArgumentException

__debugInfo()source public

__debugInfo( )

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

Возвращает

array

__destruct()source public

__destruct( )

Деструктор

autoQuoting()source public

autoQuoting( boolean|null $enable null )

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

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

Параметры

boolean|null $enable необязательно null
включить или отключить автоматическое цитирование

Возвращает

boolean

beginTransaction()source abstract public

beginTransaction( )

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

Возвращает

boolean
true при успехе, false в противном случае

commitTransaction()source abstract public

commitTransaction( )

Завершает транзакцию

Возвращает

boolean
true при успехе, false в противном случае
END_OF_DOCUMENT_MARKER

compileQuery()source public

compileQuery( Cake\Database\Query $query , Cake\Database\ValueBinder $generator )

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

Параметры

Cake\Database\Query $query
Запрос для компиляции.
Cake\Database\ValueBinder $generator
Используемый обработчик значений.

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

array

содержащий 2 записи. Первый элемент — преобразованный запрос, а второй — скомпилированная строка SQL


connect()source abstract public

connect( )

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

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

boolean
true при успехе

connection()source abstract public

connection( null|PDO $connection null )

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

Параметры

null|PDO $connection optional null
Объект соединения

disableForeignKeySQL()source abstract public

disableForeignKeySQL( )

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

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

string

disconnect()source abstract public

disconnect( )

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

enableForeignKeySQL()source abstract public

enableForeignKeySQL( )

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

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

string

enabled()source abstract public

enabled( )

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

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

boolean
true, если этот драйвер допустимо использовать

isConnected()source public

isConnected( )

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

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

boolean

lastInsertId()source public

lastInsertId( string|null $table null , string|null $column null )

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

Параметры

string|null $table optional null
Имя таблицы или последовательности для получения последнего значения вставки
string|null $column optional null
Имя столбца, представляющего первичный ключ

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

string|integer

newCompiler()source public

newCompiler( )

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

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

Cake\Database\QueryCompiler

prepare()source abstract public

prepare( string|Cake\Database\Query $query )

Подготавливает оператор SQL для выполнения

Параметры

string|Cake\Database\Query $query
Запрос, который нужно преобразовать в оператор.

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

Cake\Database\StatementInterface

queryTranslator()source abstract public

queryTranslator( string $type )

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

Параметры

string $type

тип запроса, который требуется преобразовать (select, insert, update, delete)

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

callable

quote()source abstract public

quote( mixed $value , string $type )

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

Параметры

mixed $value
Значение для кавычек.
string $type
Тип, используемый для определения вида кавычек

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

string

quoteIdentifier()source abstract public

quoteIdentifier( string $identifier )

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

Параметры

string $identifier
Выражение идентификатора для кавычек.

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

string

releaseSavePointSQL()source abstract public

releaseSavePointSQL( string $name )

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

Параметры

string $name
Имя таблицы

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

string

rollbackSavePointSQL()source abstract public

rollbackSavePointSQL( string $name )

Возвращает SQL для отката точки сохранения.

Параметры

string $name
Имя таблицы

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

string

rollbackTransaction()source abstract public

rollbackTransaction( )

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

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

boolean
true при успехе, false в противном случае

savePointSQL()source abstract public

savePointSQL( string $name )

Возвращает SQL для создания точки сохранения.

Параметры

string $name
Имя таблицы

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

string

schema()source public

schema( )

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

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

string

schemaDialect()source abstract public

schemaDialect( )

Возвращает диалект схемы.

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

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

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

Cake\Database\Schema\BaseSchema

schemaValue()source public

schemaValue( mixed $value )

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

Параметры

mixed $value
Значение для экранирования.

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

string
Строка для использования в определениях схем.
END_OF_DOCUMENT_MARKER

supportsDynamicConstraints()source abstract public

supportsDynamicConstraints( )

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

Возвращает

boolean
true, если драйвер поддерживает динамические ограничения

supportsQuoting()source public

supportsQuoting( )

Проверяет, поддерживает ли драйвер цитирование.

Возвращает

boolean

supportsSavePoints()source public

supportsSavePoints( )

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

Возвращает

boolean
true, если точки сохранения поддерживаются, в противном случае false

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

$_autoQuotingsource

protected boolean

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

false

$_baseConfigsource

protected array

Базовая конфигурация, которая объединяется с предоставленными пользователем данными конфигурации.

[]

$_configsource

protected array

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

© 2005–2017 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.3/class-Cake.Database.Driver.html

Spec-Zone.ru

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