Интерфейс TableSchemaInterface
Интерфейс, используемый объектами TableSchema базы данных.
Константы
-
stringTYPE_BIGINTEGER'biginteger'
Тип колонки Big Integer
-
stringTYPE_BINARY'binary'
Тип колонки Binary
-
stringTYPE_BINARY_UUID'binaryuuid'
Тип колонки Binary UUID
-
stringTYPE_BOOLEAN'boolean'
Тип колонки Boolean
-
stringTYPE_CHAR'char'
Тип колонки Char
-
stringTYPE_DATE'date'
Тип колонки Date
-
stringTYPE_DATETIME'datetime'
Тип колонки DateTime
-
stringTYPE_DATETIME_FRACTIONAL'datetimefractional'
Тип колонки DateTime с дробной частью секунды
-
stringTYPE_DECIMAL'decimal'
Тип колонки Decimal
-
stringTYPE_FLOAT'float'
Тип колонки Float
-
stringTYPE_INTEGER'integer'
Тип колонки Integer
-
stringTYPE_JSON'json'
Тип колонки JSON
-
stringTYPE_SMALLINTEGER'smallinteger'
Тип колонки Small Integer
-
stringTYPE_STRING'string'
Тип колонки String
-
stringTYPE_TEXT'text'
Тип колонки Text
-
stringTYPE_TIME'time'
Тип колонки Time
-
stringTYPE_TIMESTAMP'timestamp'
Тип колонки Timestamp
-
stringTYPE_TIMESTAMP_FRACTIONAL'timestampfractional'
Тип колонки Timestamp с дробной частью секунды
-
stringTYPE_TIMESTAMP_TIMEZONE'timestamptimezone'
Тип колонки Timestamp с часовым поясом
-
stringTYPE_TINYINTEGER'tinyinteger'
Тип колонки Tiny Integer
-
stringTYPE_UUID'uuid'
Тип колонки UUID
Краткое описание методов
-
addColumn() public
Добавить столбец в таблицу.
-
addConstraint() public
Добавить ограничение.
-
addIndex() public
Добавить индекс.
-
baseColumnType() public
Возвращает имя базового типа для указанного столбца. Это представляет собой тип базы данных, на котором основан более сложный класс.
-
columns() public
Получить имена столбцов в таблице.
-
constraints() public
Получить имена всех ограничений в таблице.
-
defaultValues() public
Получить хеш столбцов и их значений по умолчанию.
-
dropConstraint() public
Удалить ограничение.
-
getColumn() public
Получить данные столбца в таблице.
-
getColumnType() public
Возвращает тип столбца или null, если столбец не существует.
-
getConstraint() public
Считать информацию об ограничении по имени.
-
getIndex() public
Считать информацию об индексе по имени.
-
getOptions() public
Получить параметры таблицы.
-
getPrimaryKey() public
Получить столбец(ы), используемый(ые) для первичного ключа.
-
hasAutoincrement() public
Проверить, определен ли в таблице столбец autoIncrement.
-
hasColumn() public
Возвращает true, если столбец существует в схеме.
-
indexes() public
Получить имена всех индексов в таблице.
-
isNullable() public
Проверить, является ли поле необязательным.
-
isTemporary() public
Получить, является ли таблица временной в базе данных.
-
name() public
Получить имя таблицы.
-
removeColumn() public
Удалить столбец из схемы таблицы.
-
setColumnType() public
Устанавливает тип столбца.
-
setOptions() public
Устанавливает параметры таблицы.
-
setTemporary() public
Устанавливает, является ли таблица временной в базе данных.
-
typeMap() public
Возвращает массив, где ключи — имена столбцов в схеме, а значения — типы баз данных, которые они имеют.
Краткое описание методов
addColumn() public
addColumn(string $name, string|array $attrs): $this
Добавить столбец в таблицу.
Атрибуты
Столбцы могут иметь несколько атрибутов:
-
typeТип столбца. Должен быть одним из абстрактных типов CakePHP. -
lengthДлина столбца. -
precisionКоличество десятичных знаков для хранения типов float и decimal. -
defaultЗначение по умолчанию для столбца. -
nullМожет ли столбец содержать NULL значения. -
fixedЯвляется ли столбец столбцом фиксированной длины. Присутствует/действительно только для строковых столбцов. -
unsignedЯвляется ли столбец беззнаковым. Присутствует/действительно только для столбцов типа integer, decimal, float.
В дополнение к указанным выше ключам, следующие ключи реализованы в некоторых, но не во всех диалектах баз данных:
-
commentКомментарий к столбцу.
Параметры
-
string$name Имя столбца
-
string|array$attrs Атрибуты для столбца или имя типа.
Возвращаемое значение
$thisaddConstraint() public
addConstraint(string $name, array|string $attrs): $this
Добавить ограничение.
Используется для добавления ограничений к таблице. Например, первичные ключи, уникальные ключи и внешние ключи.
Атрибуты
-
typeТип добавляемого ограничения. -
columnsСтолбцы в индексе. -
referencesТаблица, столбец, на который ссылается внешний ключ. -
updateПоведение при обновлении. Варианты: 'restrict', 'setNull', 'cascade', 'noAction'. -
deleteПоведение при удалении. Варианты: 'restrict', 'setNull', 'cascade', 'noAction'.
Значение по умолчанию для 'update' & 'delete' - 'cascade'.
Параметры
-
string$name Имя ограничения.
-
array|string$attrs Атрибуты для ограничения. Если строка, она будет использоваться как
type.
Возвращаемое значение
$thisИсключения
Cake\Database\Exception\DatabaseExceptionaddIndex() public
addIndex(string $name, array|string $attrs): $this
Добавить индекс.
Используется для добавления индексов и индексов полного текста в платформах, которые их поддерживают.
Атрибуты
-
typeТип добавляемого индекса. -
columnsСтолбцы в индексе.
Параметры
-
string$name Имя индекса.
-
array|string$attrs Атрибуты для индекса. Если строка, она будет использоваться как
type.
Возвращаемое значение
$thisИсключения
Cake\Database\Exception\DatabaseExceptionbaseColumnType() public
baseColumnType(string $column): string|null
Возвращает базовое имя типа для предоставленного столбца. Это представляет тип базы данных, на котором основан более сложный класс.
Параметры
-
string$column Имя столбца, для которого нужно получить базовый тип
Возвращаемое значение
string|nullcolumns() public
columns(): string[]
Получить имена столбцов в таблице.
Возвращаемое значение
string[]constraints() public
constraints(): string[]
Получить имена всех ограничений в таблице.
Возвращаемое значение
string[]defaultValues() public
defaultValues(): array
Получить хеш столбцов и их значений по умолчанию.
Возвращаемое значение
arraydropConstraint() public
dropConstraint(string $name): $this
Удалить ограничение.
Параметры
-
string$name Имя ограничения для удаления
Возвращаемое значение
$thisgetColumn() public
getColumn(string $name): array|null
Получить данные столбца в таблице.
Параметры
-
string$name Имя столбца.
Возвращаемое значение
array|nullgetColumnType() public
getColumnType(string $name): string|null
Возвращает тип столбца или null, если столбец не существует.
Параметры
-
string$name Столбец, для которого нужно получить тип.
Возвращаемое значение
string|nullgetConstraint() public
getConstraint(string $name): array|null
Прочитать информацию об ограничении по имени.
Параметры
-
string$name Имя ограничения.
Возвращаемое значение
array|nullgetIndex() public
getIndex(string $name): array|null
Прочитать информацию об индексе по имени.
Параметры
-
string$name Имя индекса.
Возвращаемое значение
array|nullgetOptions() public
getOptions(): array
Получает параметры для таблицы.
Параметры таблицы позволяют устанавливать параметры уровня таблицы, зависящие от платформы. Например, тип движка в MySQL.
Возвращаемое значение
arraygetPrimaryKey() public
getPrimaryKey(): array
Получить столбец(ы), используемый(ые) для первичного ключа.
Возвращаемое значение
arrayhasAutoincrement() public
hasAutoincrement(): bool
Проверить, определён ли в таблице столбец с autoIncrement.
Возвращаемое значение
boolhasColumn() public
hasColumn(string $name): bool
Возвращает true, если столбец существует в схеме.
Параметры
-
string$name Имя столбца.
Возвращаемое значение
boolindexes() public
indexes(): string[]
Получить имена всех индексов в таблице.
Возвращаемое значение
string[]isNullable() public
isNullable(string $name): bool
Проверить, является ли поле допускающим NULL значения.
Отсутствующие столбцы допускают NULL.
Параметры
-
string$name Столбец, для которого нужно получить тип.
Возвращаемое значение
boolisTemporary() public
isTemporary(): bool
Возвращает, является ли таблица временной в базе данных.
Возвращаемое значение
boolname() public
name(): string
Получить имя таблицы.
Возвращаемое значение
stringremoveColumn() public
removeColumn(string $name): $this
Удалить столбец из схемы таблицы.
Если столбец не определен в таблице, ошибка не будет вызвана.
Параметры
-
string$name Имя столбца
Возвращаемое значение
$thissetColumnType() public
setColumnType(string $name, string $type): $this
Устанавливает тип столбца.
Параметры
-
string$name Столбец, для которого нужно установить тип.
-
string$type Тип, который нужно установить для столбца.
Возвращает
$thissetOptions() public
setOptions(array $options): $this
Устанавливает параметры таблицы.
Параметры таблицы позволяют задавать платформозависимые параметры уровня таблицы. Например, тип движка в MySQL.
Параметры
-
array$options Параметры для установки, или null для чтения параметров.
Возвращает
$thissetTemporary() public
setTemporary(bool $temporary): $this
Устанавливает, является ли таблица временной в базе данных.
Параметры
-
bool$temporary Является ли таблица временной.
Возвращает
$thistypeMap() public
typeMap(): array
Возвращает массив, где ключи — имена столбцов в схеме, а значения — типы данных базы данных, которым они соответствуют.
Возвращает
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/4.2/interface-Cake.Database.Schema.TableSchemaInterface.html