Class TableSchema

Represents a single table in a database schema.

Can either be populated using the reflection API's or by incrementally building an instance using methods.

Once created TableSchema instances can be added to Schema\Collection objects. They can also be converted into SQL using the createSql(), dropSql() and truncateSql() methods.

Namespace: Cake\Database\Schema

Constants

string

ACTION_CASCADE ¶
```
'cascade'
```
Foreign key cascade action
string

ACTION_NO_ACTION ¶
```
'noAction'
```
Foreign key no action
string

ACTION_RESTRICT ¶
```
'restrict'
```
Foreign key restrict action
string

ACTION_SET_DEFAULT ¶
```
'setDefault'
```
Foreign key restrict default
string

ACTION_SET_NULL ¶
```
'setNull'
```
Foreign key set null action
string

CONSTRAINT_FOREIGN ¶
```
'foreign'
```
Foreign constraint type
string

CONSTRAINT_PRIMARY ¶
```
'primary'
```
Primary constraint type
string

CONSTRAINT_UNIQUE ¶
```
'unique'
```
Unique constraint type
string

INDEX_FULLTEXT ¶
```
'fulltext'
```
Fulltext index type
string

INDEX_INDEX ¶
```
'index'
```
Index - index type
int

LENGTH_LONG ¶
```
4294967295
```
Column length when using a long column type
int

LENGTH_MEDIUM ¶
```
16777215
```
Column length when using a medium column type
int

LENGTH_TINY ¶
```
255
```
Column length when using a tiny column type
string

TYPE_BIGINTEGER ¶
```
'biginteger'
```
Big Integer column type
string

TYPE_BINARY ¶
```
'binary'
```
Binary column type
string

TYPE_BINARY_UUID ¶
```
'binaryuuid'
```
Binary UUID column type
string

TYPE_BOOLEAN ¶
```
'boolean'
```
Boolean column type
string

TYPE_DATE ¶
```
'date'
```
Date column type
string

TYPE_DATETIME ¶
```
'datetime'
```
Datetime column type
string

TYPE_DECIMAL ¶
```
'decimal'
```
Decimal column type
string

TYPE_FLOAT ¶
```
'float'
```
Float column type
string

TYPE_INTEGER ¶
```
'integer'
```
Integer column type
string

TYPE_JSON ¶
```
'json'
```
JSON column type
string

TYPE_SMALLINTEGER ¶
```
'smallinteger'
```
Small Integer column type
string

TYPE_STRING ¶
```
'string'
```
String column type
string

TYPE_TEXT ¶
```
'text'
```
Text column type
string

TYPE_TIME ¶
```
'time'
```
Time column type
string

TYPE_TIMESTAMP ¶
```
'timestamp'
```
Timestamp column type
string

TYPE_TINYINTEGER ¶
```
'tinyinteger'
```
Tiny Integer column type
string

TYPE_UUID ¶
```
'uuid'
```
UUID column type

Property Summary

$_columnExtras protected static

array

Additional type specific properties.
$_columnKeys protected static

array

The valid keys that can be used in a column definition.
$_columns protected

array

Columns in the table.
$_constraints protected

array

Constraints in the table.
$_indexKeys protected static

array

The valid keys that can be used in an index definition.
$_indexes protected

array

Indexes in the table.
$_options protected

array

Options for the table.
$_table protected

string

The name of the table
$_temporary protected

bool

Whether or not the table is temporary
$_typeMap protected

array

A map with columns to types
$_validConstraintTypes protected static

array

Names of the valid constraint types.
$_validForeignKeyActions protected static

array

Names of the valid foreign key actions.
$_validIndexTypes protected static

array

Names of the valid index types.
$columnLengths public static

array

Valid column length that can be used with text type columns

Method Summary

__construct() public

Constructor.
__debugInfo() public

Returns an array of the table schema.
_checkForeignKey() protected

Helper method to check/validate foreign keys.
addColumn() public

Add a column to the table.
addConstraint() public

Add a constraint.
addConstraintSql() public

Generate the SQL statements to add the constraints to the table
addIndex() public

Add an index.
baseColumnType() public

Returns the base type name for the provided column. This represent the database type a more complex class is based upon.
column() public deprecated

Get column data in the table.
columnType() public deprecated

Sets the type of a column, or returns its current type if none is passed.
columns() public

Get the column names in the table.
constraint() public deprecated

Read information about a constraint based on name.
constraints() public

Get the names of all the constraints in the table.
createSql() public

Generate the SQL to create the Table.
defaultValues() public

Get a hash of columns and their default values.
dropConstraint() public

Remove a constraint.
dropConstraintSql() public

Generate the SQL statements to drop the constraints to the table
dropSql() public

Generate the SQL to drop a table.
getColumn() public

Get column data in the table.
getColumnType() public

Returns column type or null if a column does not exist.
getConstraint() public

Read information about a constraint based on name.
getIndex() public

Read information about an index based on name.
getOptions() public

Gets the options for a table.
hasAutoincrement() public

Check whether or not a table has an autoIncrement column defined.
hasColumn() public

Returns true if a column exists in the schema.
index() public deprecated

Read information about an index based on name.
indexes() public

Get the names of all the indexes in the table.
isNullable() public

Check whether or not a field is nullable
isTemporary() public

Gets whether the table is temporary in the database.
name() public

Get the name of the table.
options() public deprecated

Get/set the options for a table.
primaryKey() public

Get the column(s) used for the primary key.
removeColumn() public

Remove a column from the table schema.
setColumnType() public

Sets the type of a column.
setOptions() public

Sets the options for a table.
setTemporary() public

Sets whether the table is temporary in the database.
temporary() public deprecated

Get/Set whether the table is temporary in the database
truncateSql() public

Generate the SQL statements to truncate a table
typeMap() public

Returns an array where the keys are the column names in the schema and the values the database type they have.

Method Detail

__construct() ¶ public

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

Constructor.

Parameters

string $table: The table name.
array $columns optional: The list of columns for the schema.

__debugInfo() ¶ public

__debugInfo(): array

Returns an array of the table schema.

Returns

array

_checkForeignKey() ¶ protected

_checkForeignKey(array $attrs): array

Helper method to check/validate foreign keys.

Parameters

array $attrs: Attributes to set.

Returns

array

Throws

Cake\Database\Exception
When foreign key definition is not valid.

addColumn() ¶ public

addColumn(string $name, array|string $attrs): $this

Add a column to the table.

Attributes

Columns can have several attributes:

type The type of the column. This should be one of CakePHP's abstract types.
length The length of the column.
precision The number of decimal places to store for float and decimal types.
default The default value of the column.
null Whether or not the column can hold nulls.
fixed Whether or not the column is a fixed length column. This is only present/valid with string columns.
unsigned Whether or not the column is an unsigned column. This is only present/valid for integer, decimal, float columns.

In addition to the above keys, the following keys are implemented in some database dialects, but not all:

comment The comment for the column.

Parameters

string $name
array|string $attrs

Returns

$this

addConstraint() ¶ public

addConstraint(string $name, array $attrs): $this

Add a constraint.

Used to add constraints to a table. For example primary keys, unique keys and foreign keys.

Attributes

type The type of constraint being added.
columns The columns in the index.
references The table, column a foreign key references.
update The behavior on update. Options are 'restrict', 'setNull', 'cascade', 'noAction'.
delete The behavior on delete. Options are 'restrict', 'setNull', 'cascade', 'noAction'.

The default for 'update' & 'delete' is 'cascade'.

Parameters

string $name
array $attrs

Returns

$this

Throws

Cake\Database\Exception

addConstraintSql() ¶ public

addConstraintSql(Cake\Database\Connection $connection): array

Generate the SQL statements to add the constraints to the table

Parameters

Cake\Database\Connection $connection

Returns

array

addIndex() ¶ public

addIndex(string $name, array $attrs): $this

Add an index.

Used to add indexes, and full text indexes in platforms that support them.

Attributes

type The type of index being added.
columns The columns in the index.

Parameters

string $name
array $attrs

Returns

$this

Throws

Cake\Database\Exception

baseColumnType() ¶ public

baseColumnType(string $column): string|null

Returns the base type name for the provided column. This represent the database type a more complex class is based upon.

Parameters

string $column

Returns

string|null

column() ¶ public

column(string $name): array|null

Get column data in the table.

Parameters

string $name: The column name.

Returns

array|null

columnType() ¶ public

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

Sets the type of a column, or returns its current type if none is passed.

Parameters

string $name: The column to get the type of.
string|null $type optional: The type to set the column to.

Returns

string|null

columns() ¶ public

columns(): string[]

Get the column names in the table.

Returns

string[]

constraint() ¶ public

constraint(string $name): array|null

Read information about a constraint based on name.

Parameters

string $name: The name of the constraint.

Returns

array|null

constraints() ¶ public

constraints(): string[]

Get the names of all the constraints in the table.

Returns

string[]

createSql() ¶ public

createSql(Cake\Database\Connection $connection): array

Generate the SQL to create the Table.

Uses the connection to access the schema dialect to generate platform specific SQL.

Parameters

Cake\Database\Connection $connection

Returns

array

defaultValues() ¶ public

defaultValues(): array

Get a hash of columns and their default values.

Returns

array

dropConstraint() ¶ public

dropConstraint(string $name): $this

Remove a constraint.

Parameters

string $name

Returns

$this

dropConstraintSql() ¶ public

dropConstraintSql(Cake\Database\Connection $connection): array

Generate the SQL statements to drop the constraints to the table

Parameters

Cake\Database\Connection $connection

Returns

array

dropSql() ¶ public

dropSql(Cake\Database\Connection $connection): array

Generate the SQL to drop a table.

Uses the connection to access the schema dialect to generate platform specific SQL.

Parameters

Cake\Database\Connection $connection

Returns

array

getColumn() ¶ public

getColumn(string $name): array|null

Get column data in the table.

Parameters

string $name

Returns

array|null

getColumnType() ¶ public

getColumnType(string $name): string|null

Returns column type or null if a column does not exist.

Parameters

string $name

Returns

string|null

getConstraint() ¶ public

getConstraint(string $name): array|null

Read information about a constraint based on name.

Parameters

string $name

Returns

array|null

getIndex() ¶ public

getIndex(string $name): array|null

Read information about an index based on name.

Parameters

string $name

Returns

array|null

getOptions() ¶ public

getOptions(): array

Gets the options for a table.

Table options allow you to set platform specific table level options. For example the engine type in MySQL.

Returns

array

hasAutoincrement() ¶ public

hasAutoincrement(): bool

Check whether or not a table has an autoIncrement column defined.

Returns

bool

hasColumn() ¶ public

hasColumn(string $name): bool

Returns true if a column exists in the schema.

Parameters

string $name

Returns

bool

index() ¶ public

index(string $name): array|null

Read information about an index based on name.

Parameters

string $name: The name of the index.

Returns

array|null

indexes() ¶ public

indexes(): string[]

Get the names of all the indexes in the table.

Returns

string[]

isNullable() ¶ public

isNullable(string $name): bool

Check whether or not a field is nullable

Missing columns are nullable.

Parameters

string $name

Returns

bool

isTemporary() ¶ public

isTemporary(): bool

Gets whether the table is temporary in the database.

Returns

bool

name() ¶ public

name(): string

Get the name of the table.

Returns

string

options() ¶ public

options(array|null $options = null): $this|array

Get/set the options for a table.

Table options allow you to set platform specific table level options. For example the engine type in MySQL.

Parameters

array|null $options optional: The options to set, or null to read options.

Returns

$this|array

primaryKey() ¶ public

primaryKey(): array

Get the column(s) used for the primary key.

Returns

array

removeColumn() ¶ public

removeColumn(string $name): $this

Remove a column from the table schema.

If the column is not defined in the table, no error will be raised.

Parameters

string $name

Returns

$this

setColumnType() ¶ public

setColumnType(string $name, string $type): $this

Sets the type of a column.

Parameters

string $name
string $type

Returns

$this

setOptions() ¶ public

setOptions(array $options): $this

Sets the options for a table.

Table options allow you to set platform specific table level options. For example the engine type in MySQL.

Parameters

array $options

Returns

$this

setTemporary() ¶ public

setTemporary(bool $temporary): $this

Sets whether the table is temporary in the database.

Parameters

bool $temporary

Returns

$this

temporary() ¶ public

temporary(bool|null $temporary = null): $this|bool

Get/Set whether the table is temporary in the database

Parameters

bool|null $temporary optional: whether or not the table is to be temporary

Returns

$this|bool

truncateSql() ¶ public

truncateSql(Cake\Database\Connection $connection): array

Generate the SQL statements to truncate a table

Parameters

Cake\Database\Connection $connection

Returns

array

typeMap() ¶ public

typeMap(): array

Returns an array where the keys are the column names in the schema and the values the database type they have.

Returns

array

array

Namespaces

Class TableSchema

Constants

Property Summary

Method Summary

__construct() public

__debugInfo() public

_checkForeignKey() protected

addColumn() public

addConstraint() public

addConstraintSql() public

addIndex() public

baseColumnType() public

column() public deprecated

columnType() public deprecated

columns() public

constraint() public deprecated

constraints() public

createSql() public

defaultValues() public

dropConstraint() public

dropConstraintSql() public

dropSql() public

getColumn() public

getColumnType() public

getConstraint() public

getIndex() public

getOptions() public

hasAutoincrement() public

hasColumn() public

index() public deprecated

indexes() public

isNullable() public

isTemporary() public

name() public

options() public deprecated

primaryKey() public

removeColumn() public

setColumnType() public

setOptions() public

setTemporary() public

temporary() public deprecated

truncateSql() public

typeMap() public

Method Detail

__construct() ¶ public

Parameters

__debugInfo() ¶ public

Returns

_checkForeignKey() ¶ protected

Parameters

Returns

Throws

addColumn() ¶ public

Attributes

Parameters

Returns

addConstraint() ¶ public

Attributes

Parameters

Returns

Throws

addConstraintSql() ¶ public

Parameters

Returns

addIndex() ¶ public

Attributes

Parameters

Returns

Throws

baseColumnType() ¶ public

Parameters

Returns

column() ¶ public

Parameters

Returns

columnType() ¶ public

Parameters

Returns

columns() ¶ public