Класс Driver
Представляет драйвер базы данных, содержащий все особенности движка базы данных, включая его диалект SQL.
- Cake\Database\Driver реализует Cake\Database\DriverInterface
Прямые подклассы
- Cake\Database\Driver\Mysql
- Cake\Database\Driver\Postgres
- Cake\Database\Driver\Sqlite
- Cake\Database\Driver\Sqlserver
Резюме свойств
-
$_autoQuotingprotectedbooleanУказывает, выполняет ли драйвер автоматическое цитирование идентификаторов для всех запросов
-
$_baseConfigprotectedarrayБазовая конфигурация, которая объединяется с предоставленными пользователем данными конфигурации.
-
$_configprotectedДанные конфигурации.array -
$_connectionprotectedЭкземпляр PDO.PDO|null
Резюме методов
- __construct() publicКонструктор
- __debugInfo() public
Возвращает массив, который можно использовать для описания внутреннего состояния этого объекта.
- __destruct() publicДеструктор
- _connect() protectedУстанавливает подключение к серверу базы данных
-
Возвращает, следует ли этому драйверу автоматически цитировать идентификаторы в запросах
- beginTransaction() publicНачинает транзакцию.
- commitTransaction() publicПодтверждает транзакцию.
- compileQuery() public
Преобразует переданный запрос в диалект этого драйвера и возвращает экземпляр преобразованного запроса и полную скомпилированную строку SQL.
- Устанавливает подключение к серверу базы данных.
-
Возвращает правильный ресурс или объект подключения, который используется во внутренней работе. Если первый аргумент передан, он установит внутренний объект или результат подключения на переданное значение.
- disableAutoQuoting() publicОтключить автоматическое цитирование идентификаторов в запросах.
- Получить SQL для отключения внешних ключей.
- disconnect() publicОтключается от сервера базы данных.
- enableAutoQuoting() public
Устанавливает, следует ли этому драйверу автоматически цитировать идентификаторы в запросах.
- Получить SQL для включения внешних ключей.
- Возвращает, может ли php использовать этот драйвер для подключения к базе данных.
- getConnection() publicПолучить внутренний экземпляр подключения PDO.
- isAutoQuotingEnabled() public
Возвращает, следует ли этому драйверу автоматически цитировать идентификаторы в запросах.
- isConnected() publicПроверяет, подключен ли драйвер.
- lastInsertId() publicВозвращает последний сгенерированный идентификатор для таблицы или последовательности в базе данных.
- newCompiler() publicВозвращает экземпляр QueryCompiler.
- prepare() publicПодготавливает sql-запрос к выполнению.
-
Возвращает вызываемую функцию, которая будет использоваться для преобразования переданного объекта Query. Эта функция, в свою очередь, вернёт экземпляр объекта Query, который был преобразован для соответствия любым особенностям диалекта SQL, используемого в настоящий момент.
- quote() publicВозвращает значение в безопасном представлении, чтобы его можно было использовать в строке запроса
-
Цитирует идентификатор базы данных (имя столбца, имя таблицы и т.д.) для безопасного использования в запросах без риска использования зарезервированных слов.
- Получить SQL для освобождения точки сохранения.
- Получить SQL для отката точки сохранения.
- rollbackTransaction() publicОткатывает транзакцию.
- Получить SQL для создания точки сохранения.
- schema() publicВозвращает имя схемы, используемой в настоящий момент.
- Получить диалект схемы.
- schemaValue() publicЭкранирует значения для использования в определениях схем.
- setConnection() publicУстановить внутренний экземпляр подключения PDO.
-
Возвращает, поддерживает ли драйвер добавление или удаление ограничений для уже созданных таблиц.
- supportsQuoting() publicПроверяет, поддерживает ли драйвер цитирование, так как PDO_ODBC его не поддерживает.
- supportsSavePoints() publicВозвращает, поддерживает ли этот драйвер точки сохранения для вложенных транзакций.
Подробное описание методов
__construct()source public
__construct( array $config = [] )
Конструктор
Параметры
- array
$configнеобязательно [] - Конфигурация для драйвера.
Исключение
InvalidArgumentException__debugInfo()source public
__debugInfo( )
Возвращает массив, который можно использовать для описания внутреннего состояния этого объекта.
Возвращаемое значение
array_connect()source protected
_connect( string $dsn , array $config )
Устанавливает соединение с сервером базы данных
Параметры
- строка
$dsn - Указатель PDO-DSN, специфичный для драйвера
- массив
$config - Настройка, используемая для создания соединения
Возвращает
booleantrue при успехе
autoQuoting()source public deprecated
autoQuoting( boolean|null $enable = null )
Возвращает значение, указывающее, нужно ли автоматически указывать идентификаторы в запросах
Если вызов с аргументом boolean, то переключает авто-указание на переданное значение
Устарело
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() connect()source abstract public
connect( )
Устанавливает соединение с сервером базы данных.
Возвращает
booleanTrue при успехе, иначе false.
Реализация
Cake\Database\DriverInterface::connect() 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-код для включения внешних ключей.
Возвращает
строкаРеализация
Cake\Database\DriverInterface::enableForeignKeySQL() enabled()source abstract public
enabled( )
Возвращает значение, указывающее, может ли php использовать этот драйвер для подключения к базе данных.
Возвращает
booleanTrue, если этот драйвер допустимо использовать.
Реализация
Cake\Database\DriverInterface::enabled() 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 )
Возвращает последний сгенерированный идентификатор для таблицы или последовательности в базе данных.
Параметры
- строка|null
$tableнеобязательно null - Имя таблицы или последовательности для получения последнего значения вставки.
- строка|null
$columnнеобязательно null - Имя столбца, представляющего первичный ключ.
Возвращает
строка|целое числоРеализация
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-запрос для выполнения.
Параметры
- строка|
Cake\Database\Query$query - Запрос, который нужно преобразовать в подготовленный запрос.
Возвращает
Cake\Database\StatementInterfaceРеализация
Cake\Database\DriverInterface::prepare() queryTranslator()source abstract public
queryTranslator( string $type )
Возвращает вызываемую функцию, которая будет использоваться для преобразования переданного объекта Query. Эта функция, в свою очередь, вернёт экземпляр объекта Query, который был преобразован для соответствия специфике используемого диалекта SQL.
Параметры
- строка
$type Тип запроса, который необходимо преобразовать (select, insert, update, delete).
Возвращает
вызываемая функцияРеализация
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Истина при успехе, ложь в противном случае.
Реализация
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() supportsDynamicConstraints()source abstract public
supportsDynamicConstraints( )
Возвращает, поддерживает ли драйвер добавление или удаление ограничений к уже созданным таблицам.
Возвращает
booleantrue, если драйвер поддерживает динамические ограничения.
Реализация
Cake\Database\DriverInterface::supportsDynamicConstraints() supportsQuoting()source public
supportsQuoting( )
Проверяет, поддерживает ли драйвер форматирование, так как PDO_ODBC его не поддерживает.
Возвращает
booleanРеализация
Cake\Database\DriverInterface::supportsQuoting() supportsSavePoints()source public
supportsSavePoints( )
Возвращает, поддерживает ли этот драйвер точки сохранения для вложенных транзакций.
Возвращает
booleanИстина, если точки сохранения поддерживаются, ложь в противном случае.
Реализация
Cake\Database\DriverInterface::supportsSavePoints() Подробное описание свойств
$_autoQuotingsource
protected boolean
Указывает, выполняет ли драйвер автоматическое форматирование идентификаторов для всех запросов
false
$_baseConfigsource
protected array
Базовая конфигурация, которая сливается с предоставленными пользователем данными конфигурации.
[]
© 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.8/class-Cake.Database.Driver.html