Класс Таблица

__construct()source public

__construct( string $table , array $columns [] )

Конструктор.

Параметры

строка $table

Имя таблицы.

массив $columns необязательно []

Список столбцов для схемы.

_checkForeignKey()source protected

_checkForeignKey( array $attrs )

Вспомогательный метод для проверки/валидации внешних ключей.

Параметры

массив $attrs

Атрибуты для установки.

Возвращает

массив

Исключения

Cake\Database\Exception
При некорректном определении внешнего ключа.

addColumn()source public

addColumn( string $name , array $attrs )

Добавить столбец в таблицу.

Атрибуты

Столбцы могут иметь несколько атрибутов:

• type Тип столбца. Он должен быть одним из абстрактных типов CakePHP.
• length Длина столбца.
• precision Количество знаков после запятой для типов float и decimal.
• default Значение по умолчанию столбца.
• null Возможность хранения NULL-значений в столбце.
• fixed Является ли столбец столбцом фиксированной длины. Он присутствует/действителен только для столбцов типа string.
• unsigned Является ли столбец беззнаковым. Присутствует/действителен только для столбцов integer, decimal, float.

В дополнение к вышеперечисленным ключам, следующие ключи реализованы в некоторых диалектах баз данных, но не во всех:

• comment Комментарий к столбцу.

Параметры

строка $name

Имя столбца

массив $attrs

Атрибуты для столбца.

Возвращает

$this

addConstraint()source public

addConstraint( string $name , array $attrs )

Добавить ограничение.

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

Атрибуты

• type Тип добавляемого ограничения.
• columns Столбцы в индексе.
• references Таблица, столбец, к которому ссылается внешний ключ.
• update Поведение при обновлении. Варианты: 'restrict', 'setNull', 'cascade', 'noAction'.
• delete Поведение при удалении. Варианты: 'restrict', 'setNull', 'cascade', 'noAction'.

По умолчанию для 'update' и 'delete' используется 'cascade'.

Параметры

строка $name

Имя ограничения.

массив $attrs

Атрибуты для ограничения.

Возвращает

$this

Исключения

Cake\Database\Exception

addConstraintSql()source public

addConstraintSql( Cake\Datasource\ConnectionInterface $connection )

Сгенерировать SQL-запросы для добавления ограничений к таблице

Параметры

Cake\Datasource\ConnectionInterface $connection

Подключение для генерации SQL.

Возвращает

массив
SQL для удаления таблицы.

addIndex()source public

addIndex( string $name , array $attrs )

Добавить индекс.

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

Атрибуты

• type Тип добавляемого индекса.
• columns Столбцы в индексе.

Параметры

строка $name

Имя индекса.

массив $attrs

Атрибуты для индекса.

Возвращает

$this

Исключения

Cake\Database\Exception

baseColumnType()source public

baseColumnType( string $column )

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

Параметры

строка $column

Имя столбца, для которого нужно получить базовый тип

Возвращает

строка
Имя базового типа

column()source public

column( string $name )

Получить данные столбца в таблице.

Параметры

строка $name

Имя столбца.

Возвращает

массив|null
Данные столбца или null.

columnType()source public

columnType( string $name , string|null $type null )

Устанавливает тип столбца или возвращает текущий тип, если он не передан.

Параметры

строка $name

Столбец, для которого нужно получить тип.

строка|null $type опционально null

Тип, которому нужно установить столбец.

Возвращает

строка|null
Тип столбца или null.

columns()source public

columns( )

Получить имена столбцов в таблице.

Возвращает

массив

constraint()source public

constraint( string $name )

Получить информацию о ограничении на основе имени.

Параметры

строка $name

Имя ограничения.

Возвращает

массив|null
Массив данных о ограничении или null

constraints()source public

constraints( )

Получить имена всех ограничений в таблице.

Возвращает

массив

createSql()source public

createSql( Cake\Datasource\ConnectionInterface $connection )

Сгенерировать SQL для создания таблицы.

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

Параметры

Cake\Datasource\ConnectionInterface $connection

Соединение для генерации SQL

Возвращает

массив

Список SQL-команд для создания таблицы и необходимых индексов.

defaultValues()source public

defaultValues( )

Получить хэш столбцов и их значений по умолчанию.

Возвращает

массив

dropConstraint()source public

dropConstraint( string $name )

Удалить ограничение.

Параметры

строка $name

Имя ограничения для удаления

dropConstraintSql()source public

dropConstraintSql( Cake\Datasource\ConnectionInterface $connection )

Сгенерировать SQL-команды для удаления ограничений в таблице

Параметры

Cake\Datasource\ConnectionInterface $connection

Соединение для генерации SQL.

Возвращает

массив
SQL для удаления таблицы.

dropSql()source public

dropSql( Cake\Datasource\ConnectionInterface $connection )

Сгенерировать SQL для удаления таблицы.

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

Параметры

Cake\Datasource\ConnectionInterface $connection

Соединение для генерации SQL.

Возвращает

массив
SQL для удаления таблицы.

hasAutoincrement()source public

hasAutoincrement( )

Проверить, определен ли столбец с автоинкрементом в таблице.

Возвращает

логическое значение

index()source public

index( string $name )

Получить информацию об индексе по имени.

Параметры

строка $name

Имя индекса.

Возвращает

массив|null
Массив данных об индексе или null

indexes()source public

indexes( )

Получить имена всех индексов в таблице.

Возвращает

массив

isNullable()source public

isNullable( string $name )

Проверить, является ли поле допускающим null

Пропущенные столбцы допускают null.

Параметры

строка $name

Столбец, для которого нужно получить тип.

Возвращает

логическое значение
Допускает ли поле null.

name()source public

name( )

Получить имя таблицы.

Возвращает

строка

options()source public

options( array|null $options null )

Получить/установить параметры таблицы.

Параметры таблицы позволяют установить платформозависимые параметры уровня таблицы. Например, тип движка в MySQL.

Параметры

массив|null $options опционально null

Параметры для установки или null для чтения параметров.

Возвращает

$this|массив Либо экземпляр таблицы, либо массив параметров при чтении.

primaryKey()source public

primaryKey( )

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

Возвращает

массив

Имя(на) столбца(ов) первичного ключа. Если в таблице нет первичного ключа, будет возвращён пустой список.

temporary()source public

temporary( boolean|null $set null )

Получить/установить, является ли таблица временной в базе данных

Параметры

логическое значение|null $set опционально null

является ли таблица временной

Возвращает

$this|логическое значение Либо экземпляр таблицы, либо текущее значение временной таблицы

truncateSql()source public

truncateSql( Cake\Datasource\ConnectionInterface $connection )

Сгенерировать SQL-команды для обнуления таблицы

Параметры

Cake\Datasource\ConnectionInterface $connection

Соединение для генерации SQL.

Возвращает

массив
SQL для обнуления таблицы.

typeMap()source public

typeMap( )

Возвращает массив, где ключи — имена столбцов в схеме, а значения — типы базы данных.

Возвращает

массив

[
    'string' => [
        'fixed' => null,
        'collate' => null,
    ],
    'text' => [
        'collate' => null,
    ],
    'integer' => [
        'unsigned' => null,
        'autoIncrement' => null,
    ],
    'biginteger' => [
        'unsigned' => null,
        'autoIncrement' => null,
    ],
    'decimal' => [
        'unsigned' => null,
    ],
    'float' => [
        'unsigned' => null,
    ],
]

[
    'type' => null,
    'baseType' => null,
    'length' => null,
    'precision' => null,
    'null' => null,
    'default' => null,
    'comment' => null,
]

[]

[]

[
    'type' => null,
    'columns' => [],
    'length' => [],
    'references' => [],
    'update' => 'restrict',
    'delete' => 'restrict',
]

[]

[]

false

[]

[
    self::CONSTRAINT_PRIMARY,
    self::CONSTRAINT_UNIQUE,
    self::CONSTRAINT_FOREIGN,
]

[
    self::ACTION_CASCADE,
    self::ACTION_SET_NULL,
    self::ACTION_SET_DEFAULT,
    self::ACTION_NO_ACTION,
    self::ACTION_RESTRICT,
]

[
    self::INDEX_INDEX,
    self::INDEX_FULLTEXT,
]

[
    'tiny' => self::LENGTH_TINY,
    'medium' => self::LENGTH_MEDIUM,
    'long' => self::LENGTH_LONG
]