Spec-Zone.ru › CakePHP 4.4

Класс Sqlite

Класс Sqlite

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

Константы

  • string
    FEATURE_CTE 
    'cte'

    Поддержка выражений с общим табличным выражением (с клаузой).

  • string
    FEATURE_DISABLE_CONSTRAINT_WITHOUT_TRANSACTION 
    'disable-constraint-without-transaction'

    Поддержка отключения ограничений без транзакции.

  • string
    FEATURE_JSON 
    'json'

    Поддержка собственного типа данных JSON.

  • string
    FEATURE_QUOTE 
    'quote'

    Поддержка PDO::quote().

  • string
    FEATURE_SAVEPOINT 
    'savepoint'

    Поддержка сохранения точек транзакции.

  • string
    FEATURE_TRUNCATE_WITH_CONSTRAINTS 
    'truncate-with-constraints'

    Поддержка обнуления с присоединёнными внешними ключами.

  • string
    FEATURE_WINDOW 
    'window'

    Поддержка оконных функций (все или частичные клаузы).

  • int|null
    MAX_ALIAS_LENGTH 
    null
  • array<int>
    RETRY_ERROR_CODES 
    []

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

  • $_autoQuoting protected
    bool

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

  • $_baseConfig protected
    array<string, mixed>

    Базовые настройки конфигурации для драйвера Sqlite

  • $_config protected
    array<string, mixed>

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

  • $_connection protected
    PDO

    Экземпляр PDO.

  • $_dateParts protected
    array<string, string>

    Сопоставление частей даты.

  • $_endQuote protected
    string

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

  • $_schemaDialect protected
    Cake\Database\Schema\SqliteSchemaDialect|null

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

  • $_startQuote protected
    string

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

  • $_supportsWindowFunctions protected
    bool|null

    Поддерживает ли подключённый сервер оконные функции.

  • $_version protected
    string|null

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

  • $connectRetries protected
    int

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

  • $featureVersions protected
    array<string, string>

    Сопоставление функции с версией сервера базы данных для проверки доступности функций.

END_OF_DOCUMENT_MARKER

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

  • __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.

  • _transformTupleComparison() protected

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

  • _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

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

  • inTransaction() 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.

  • supports() public

    Возвращает, поддерживает ли драйвер функцию.

END_OF_DOCUMENT_MARKER
  • supportsCTEs() public deprecated

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

  • supportsDynamicConstraints() public

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

  • supportsQuoting() public deprecated

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

  • supportsSavePoints() public

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

  • supportsWindowFunctions() public deprecated

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

  • version() public

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

Методы

__construct() public 

__construct(array<string, mixed> $config = [])

Конструктор

Параметры

array<string, mixed> $config необязательно

Настройка драйвера.

Исключения

InvalidArgumentException

__debugInfo() public 

__debugInfo(): array<string, mixed>

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

Возвращает

array<string, mixed>

__destruct() public 

__destruct()

Деструктор

_connect() protected 

_connect(string $dsn, array<string, mixed> $config): bool

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

Параметры

string $dsn

Спецификация DSN, специфичная для драйвера PDO.

array<string, mixed> $config

Конфигурация, используемая для создания соединения.

Возвращает

bool

_deleteQueryTranslator() protected 

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

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

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

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

Параметры

Cake\Database\Query $query

Запрос для трансляции

Возвращает

Cake\Database\Query

_expressionTranslators() protected 

_expressionTranslators(): array<string>

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

Возвращает

array<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

Функциональное выражение для преобразования в TSQL.

Возвращает

void

_transformTupleComparison() protected 

_transformTupleComparison(Cake\Database\Expression\TupleComparison $expression, Cake\Database\Query $query): void

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

Преобразует выражения вида '(a, b) IN ((c, d), (e, f))' в эквивалентное выражение вида '((a = c) AND (b = d)) OR ((a = e) AND (b = f))'.

Также может преобразовывать выражения, где правая часть — запрос, выбирающий такое же количество столбцов, как элементы в левой части выражения:

(a, b) IN (SELECT c, d FROM a_table) преобразуется в

1 = (SELECT 1 FROM a_table WHERE (a = c) AND (b = d))

Параметры

Cake\Database\Expression\TupleComparison $expression

Выражение для преобразования

Cake\Database\Query $query

Запрос для обновления.

Возвращает

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

inTransaction() public 

inTransaction(): bool

Возвращает, активна ли транзакция для подключения.

Returns

bool

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\QueryCompiler

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

Returns

Cake\Database\QueryCompiler

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(Cake\Database\Query|string $query): Cake\Database\StatementInterface

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

Parameters

Cake\Database\Query|string $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

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

Используется пакетом {@link \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

supports() public 

supports(string $feature): bool

Возвращает, поддерживает ли драйвер функцию.

По умолчанию true для FEATURE_QUOTE и FEATURE_SAVEPOINT.

Parameters

string $feature

Returns

bool

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

supportsWindowFunctions() public 

supportsWindowFunctions(): bool

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

Возвращает

bool

version() public 

version(): string

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

Возвращает

string

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

$_autoQuoting protected

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

Тип

bool

$_baseConfig protected

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

  • mask Маска, используемая для созданной базы данных

Тип

array<string, mixed>

$_config protected

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

Тип

array<string, mixed>

$_connection protected

Экземпляр PDO.

Тип

PDO

$_dateParts protected

Сопоставление частей даты.

Тип

array<string, string>

$_endQuote protected

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

Тип

string

$_schemaDialect protected

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

Тип

Cake\Database\Schema\SqliteSchemaDialect|null

$_startQuote protected

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

Тип

string

$_supportsWindowFunctions protected

Поддерживает ли подключенный сервер оконные функции.

Тип

bool|null

$_version protected

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

Тип

string|null

$connectRetries protected

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

Тип

int

$featureVersions protected

Сопоставление функции с версией сервера базы данных для проверки доступности функции.

Тип

array<string, string>

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

Spec-Zone.ru

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