123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571 |
- <?php
- /**
- * CakePHP(tm) : Rapid Development Framework (https://cakephp.org)
- * Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
- *
- * Licensed under The MIT License
- * For full copyright and license information, please see the LICENSE.txt
- * Redistributions of files must retain the above copyright notice.
- *
- * @copyright Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
- * @link https://cakephp.org CakePHP(tm) Project
- * @since 3.0.0
- * @license https://opensource.org/licenses/mit-license.php MIT License
- */
- namespace Cake\Database\Schema;
- use Cake\Database\Exception;
- use Cake\Database\Schema\TableSchema;
- /**
- * Schema generation/reflection features for MySQL
- */
- class MysqlSchema extends BaseSchema
- {
- /**
- * The driver instance being used.
- *
- * @var \Cake\Database\Driver\Mysql
- */
- protected $_driver;
- /**
- * {@inheritDoc}
- */
- public function listTablesSql($config)
- {
- return ['SHOW TABLES FROM ' . $this->_driver->quoteIdentifier($config['database']), []];
- }
- /**
- * {@inheritDoc}
- */
- public function describeColumnSql($tableName, $config)
- {
- return ['SHOW FULL COLUMNS FROM ' . $this->_driver->quoteIdentifier($tableName), []];
- }
- /**
- * {@inheritDoc}
- */
- public function describeIndexSql($tableName, $config)
- {
- return ['SHOW INDEXES FROM ' . $this->_driver->quoteIdentifier($tableName), []];
- }
- /**
- * {@inheritDoc}
- */
- public function describeOptionsSql($tableName, $config)
- {
- return ['SHOW TABLE STATUS WHERE Name = ?', [$tableName]];
- }
- /**
- * {@inheritDoc}
- */
- public function convertOptionsDescription(TableSchema $schema, $row)
- {
- $schema->setOptions([
- 'engine' => $row['Engine'],
- 'collation' => $row['Collation'],
- ]);
- }
- /**
- * Convert a MySQL column type into an abstract type.
- *
- * The returned type will be a type that Cake\Database\Type can handle.
- *
- * @param string $column The column type + length
- * @return array Array of column information.
- * @throws \Cake\Database\Exception When column type cannot be parsed.
- */
- protected function _convertColumn($column)
- {
- preg_match('/([a-z]+)(?:\(([0-9,]+)\))?\s*([a-z]+)?/i', $column, $matches);
- if (empty($matches)) {
- throw new Exception(sprintf('Unable to parse column type from "%s"', $column));
- }
- $col = strtolower($matches[1]);
- $length = $precision = null;
- if (isset($matches[2])) {
- $length = $matches[2];
- if (strpos($matches[2], ',') !== false) {
- list($length, $precision) = explode(',', $length);
- }
- $length = (int)$length;
- $precision = (int)$precision;
- }
- if (in_array($col, ['date', 'time', 'datetime', 'timestamp'])) {
- return ['type' => $col, 'length' => null];
- }
- if (($col === 'tinyint' && $length === 1) || $col === 'boolean') {
- return ['type' => TableSchema::TYPE_BOOLEAN, 'length' => null];
- }
- $unsigned = (isset($matches[3]) && strtolower($matches[3]) === 'unsigned');
- if (strpos($col, 'bigint') !== false || $col === 'bigint') {
- return ['type' => TableSchema::TYPE_BIGINTEGER, 'length' => $length, 'unsigned' => $unsigned];
- }
- if ($col === 'tinyint') {
- return ['type' => TableSchema::TYPE_TINYINTEGER, 'length' => $length, 'unsigned' => $unsigned];
- }
- if ($col === 'smallint') {
- return ['type' => TableSchema::TYPE_SMALLINTEGER, 'length' => $length, 'unsigned' => $unsigned];
- }
- if (in_array($col, ['int', 'integer', 'mediumint'])) {
- return ['type' => TableSchema::TYPE_INTEGER, 'length' => $length, 'unsigned' => $unsigned];
- }
- if ($col === 'char' && $length === 36) {
- return ['type' => TableSchema::TYPE_UUID, 'length' => null];
- }
- if ($col === 'char') {
- return ['type' => TableSchema::TYPE_STRING, 'fixed' => true, 'length' => $length];
- }
- if (strpos($col, 'char') !== false) {
- return ['type' => TableSchema::TYPE_STRING, 'length' => $length];
- }
- if (strpos($col, 'text') !== false) {
- $lengthName = substr($col, 0, -4);
- $length = isset(TableSchema::$columnLengths[$lengthName]) ? TableSchema::$columnLengths[$lengthName] : null;
- return ['type' => TableSchema::TYPE_TEXT, 'length' => $length];
- }
- if ($col === 'binary' && $length === 16) {
- return ['type' => TableSchema::TYPE_BINARY_UUID, 'length' => null];
- }
- if (strpos($col, 'blob') !== false || in_array($col, ['binary', 'varbinary'])) {
- $lengthName = substr($col, 0, -4);
- $length = isset(TableSchema::$columnLengths[$lengthName]) ? TableSchema::$columnLengths[$lengthName] : $length;
- return ['type' => TableSchema::TYPE_BINARY, 'length' => $length];
- }
- if (strpos($col, 'float') !== false || strpos($col, 'double') !== false) {
- return [
- 'type' => TableSchema::TYPE_FLOAT,
- 'length' => $length,
- 'precision' => $precision,
- 'unsigned' => $unsigned
- ];
- }
- if (strpos($col, 'decimal') !== false) {
- return [
- 'type' => TableSchema::TYPE_DECIMAL,
- 'length' => $length,
- 'precision' => $precision,
- 'unsigned' => $unsigned
- ];
- }
- if (strpos($col, 'json') !== false) {
- return ['type' => TableSchema::TYPE_JSON, 'length' => null];
- }
- return ['type' => TableSchema::TYPE_STRING, 'length' => null];
- }
- /**
- * {@inheritDoc}
- */
- public function convertColumnDescription(TableSchema $schema, $row)
- {
- $field = $this->_convertColumn($row['Type']);
- $field += [
- 'null' => $row['Null'] === 'YES',
- 'default' => $row['Default'],
- 'collate' => $row['Collation'],
- 'comment' => $row['Comment'],
- ];
- if (isset($row['Extra']) && $row['Extra'] === 'auto_increment') {
- $field['autoIncrement'] = true;
- }
- $schema->addColumn($row['Field'], $field);
- }
- /**
- * {@inheritDoc}
- */
- public function convertIndexDescription(TableSchema $schema, $row)
- {
- $type = null;
- $columns = $length = [];
- $name = $row['Key_name'];
- if ($name === 'PRIMARY') {
- $name = $type = TableSchema::CONSTRAINT_PRIMARY;
- }
- $columns[] = $row['Column_name'];
- if ($row['Index_type'] === 'FULLTEXT') {
- $type = TableSchema::INDEX_FULLTEXT;
- } elseif ($row['Non_unique'] == 0 && $type !== 'primary') {
- $type = TableSchema::CONSTRAINT_UNIQUE;
- } elseif ($type !== 'primary') {
- $type = TableSchema::INDEX_INDEX;
- }
- if (!empty($row['Sub_part'])) {
- $length[$row['Column_name']] = $row['Sub_part'];
- }
- $isIndex = (
- $type === TableSchema::INDEX_INDEX ||
- $type === TableSchema::INDEX_FULLTEXT
- );
- if ($isIndex) {
- $existing = $schema->getIndex($name);
- } else {
- $existing = $schema->getConstraint($name);
- }
- // MySQL multi column indexes come back as multiple rows.
- if (!empty($existing)) {
- $columns = array_merge($existing['columns'], $columns);
- $length = array_merge($existing['length'], $length);
- }
- if ($isIndex) {
- $schema->addIndex($name, [
- 'type' => $type,
- 'columns' => $columns,
- 'length' => $length
- ]);
- } else {
- $schema->addConstraint($name, [
- 'type' => $type,
- 'columns' => $columns,
- 'length' => $length
- ]);
- }
- }
- /**
- * {@inheritDoc}
- */
- public function describeForeignKeySql($tableName, $config)
- {
- $sql = 'SELECT * FROM information_schema.key_column_usage AS kcu
- INNER JOIN information_schema.referential_constraints AS rc
- ON (
- kcu.CONSTRAINT_NAME = rc.CONSTRAINT_NAME
- AND kcu.CONSTRAINT_SCHEMA = rc.CONSTRAINT_SCHEMA
- )
- WHERE kcu.TABLE_SCHEMA = ? AND kcu.TABLE_NAME = ? AND rc.TABLE_NAME = ?';
- return [$sql, [$config['database'], $tableName, $tableName]];
- }
- /**
- * {@inheritDoc}
- */
- public function convertForeignKeyDescription(TableSchema $schema, $row)
- {
- $data = [
- 'type' => TableSchema::CONSTRAINT_FOREIGN,
- 'columns' => [$row['COLUMN_NAME']],
- 'references' => [$row['REFERENCED_TABLE_NAME'], $row['REFERENCED_COLUMN_NAME']],
- 'update' => $this->_convertOnClause($row['UPDATE_RULE']),
- 'delete' => $this->_convertOnClause($row['DELETE_RULE']),
- ];
- $name = $row['CONSTRAINT_NAME'];
- $schema->addConstraint($name, $data);
- }
- /**
- * {@inheritDoc}
- */
- public function truncateTableSql(TableSchema $schema)
- {
- return [sprintf('TRUNCATE TABLE `%s`', $schema->name())];
- }
- /**
- * {@inheritDoc}
- */
- public function createTableSql(TableSchema $schema, $columns, $constraints, $indexes)
- {
- $content = implode(",\n", array_merge($columns, $constraints, $indexes));
- $temporary = $schema->isTemporary() ? ' TEMPORARY ' : ' ';
- $content = sprintf("CREATE%sTABLE `%s` (\n%s\n)", $temporary, $schema->name(), $content);
- $options = $schema->getOptions();
- if (isset($options['engine'])) {
- $content .= sprintf(' ENGINE=%s', $options['engine']);
- }
- if (isset($options['charset'])) {
- $content .= sprintf(' DEFAULT CHARSET=%s', $options['charset']);
- }
- if (isset($options['collate'])) {
- $content .= sprintf(' COLLATE=%s', $options['collate']);
- }
- return [$content];
- }
- /**
- * {@inheritDoc}
- */
- public function columnSql(TableSchema $schema, $name)
- {
- $data = $schema->getColumn($name);
- $out = $this->_driver->quoteIdentifier($name);
- $nativeJson = $this->_driver->supportsNativeJson();
- $typeMap = [
- TableSchema::TYPE_TINYINTEGER => ' TINYINT',
- TableSchema::TYPE_SMALLINTEGER => ' SMALLINT',
- TableSchema::TYPE_INTEGER => ' INTEGER',
- TableSchema::TYPE_BIGINTEGER => ' BIGINT',
- TableSchema::TYPE_BINARY_UUID => ' BINARY(16)',
- TableSchema::TYPE_BOOLEAN => ' BOOLEAN',
- TableSchema::TYPE_FLOAT => ' FLOAT',
- TableSchema::TYPE_DECIMAL => ' DECIMAL',
- TableSchema::TYPE_DATE => ' DATE',
- TableSchema::TYPE_TIME => ' TIME',
- TableSchema::TYPE_DATETIME => ' DATETIME',
- TableSchema::TYPE_TIMESTAMP => ' TIMESTAMP',
- TableSchema::TYPE_UUID => ' CHAR(36)',
- TableSchema::TYPE_JSON => $nativeJson ? ' JSON' : ' LONGTEXT'
- ];
- $specialMap = [
- 'string' => true,
- 'text' => true,
- 'binary' => true,
- ];
- if (isset($typeMap[$data['type']])) {
- $out .= $typeMap[$data['type']];
- }
- if (isset($specialMap[$data['type']])) {
- switch ($data['type']) {
- case TableSchema::TYPE_STRING:
- $out .= !empty($data['fixed']) ? ' CHAR' : ' VARCHAR';
- if (!isset($data['length'])) {
- $data['length'] = 255;
- }
- break;
- case TableSchema::TYPE_TEXT:
- $isKnownLength = in_array($data['length'], TableSchema::$columnLengths);
- if (empty($data['length']) || !$isKnownLength) {
- $out .= ' TEXT';
- break;
- }
- if ($isKnownLength) {
- $length = array_search($data['length'], TableSchema::$columnLengths);
- $out .= ' ' . strtoupper($length) . 'TEXT';
- }
- break;
- case TableSchema::TYPE_BINARY:
- $isKnownLength = in_array($data['length'], TableSchema::$columnLengths);
- if ($isKnownLength) {
- $length = array_search($data['length'], TableSchema::$columnLengths);
- $out .= ' ' . strtoupper($length) . 'BLOB';
- break;
- }
- if (empty($data['length'])) {
- $out .= ' BLOB';
- break;
- }
- if ($data['length'] > 2) {
- $out .= ' VARBINARY(' . $data['length'] . ')';
- } else {
- $out .= ' BINARY(' . $data['length'] . ')';
- }
- break;
- }
- }
- $hasLength = [
- TableSchema::TYPE_INTEGER,
- TableSchema::TYPE_SMALLINTEGER,
- TableSchema::TYPE_TINYINTEGER,
- TableSchema::TYPE_STRING
- ];
- if (in_array($data['type'], $hasLength, true) && isset($data['length'])) {
- $out .= '(' . (int)$data['length'] . ')';
- }
- $hasPrecision = [TableSchema::TYPE_FLOAT, TableSchema::TYPE_DECIMAL];
- if (in_array($data['type'], $hasPrecision, true) &&
- (isset($data['length']) || isset($data['precision']))
- ) {
- $out .= '(' . (int)$data['length'] . ',' . (int)$data['precision'] . ')';
- }
- $hasUnsigned = [
- TableSchema::TYPE_TINYINTEGER,
- TableSchema::TYPE_SMALLINTEGER,
- TableSchema::TYPE_INTEGER,
- TableSchema::TYPE_BIGINTEGER,
- TableSchema::TYPE_FLOAT,
- TableSchema::TYPE_DECIMAL
- ];
- if (in_array($data['type'], $hasUnsigned, true) &&
- isset($data['unsigned']) && $data['unsigned'] === true
- ) {
- $out .= ' UNSIGNED';
- }
- $hasCollate = [
- TableSchema::TYPE_TEXT,
- TableSchema::TYPE_STRING,
- ];
- if (in_array($data['type'], $hasCollate, true) && isset($data['collate']) && $data['collate'] !== '') {
- $out .= ' COLLATE ' . $data['collate'];
- }
- if (isset($data['null']) && $data['null'] === false) {
- $out .= ' NOT NULL';
- }
- $addAutoIncrement = (
- [$name] == (array)$schema->primaryKey() &&
- !$schema->hasAutoincrement() &&
- !isset($data['autoIncrement'])
- );
- if (in_array($data['type'], [TableSchema::TYPE_INTEGER, TableSchema::TYPE_BIGINTEGER]) &&
- ($data['autoIncrement'] === true || $addAutoIncrement)
- ) {
- $out .= ' AUTO_INCREMENT';
- }
- if (isset($data['null']) && $data['null'] === true && $data['type'] === TableSchema::TYPE_TIMESTAMP) {
- $out .= ' NULL';
- unset($data['default']);
- }
- if (isset($data['default']) &&
- in_array($data['type'], [TableSchema::TYPE_TIMESTAMP, TableSchema::TYPE_DATETIME]) &&
- in_array(strtolower($data['default']), ['current_timestamp', 'current_timestamp()'])
- ) {
- $out .= ' DEFAULT CURRENT_TIMESTAMP';
- unset($data['default']);
- }
- if (isset($data['default'])) {
- $out .= ' DEFAULT ' . $this->_driver->schemaValue($data['default']);
- unset($data['default']);
- }
- if (isset($data['comment']) && $data['comment'] !== '') {
- $out .= ' COMMENT ' . $this->_driver->schemaValue($data['comment']);
- }
- return $out;
- }
- /**
- * {@inheritDoc}
- */
- public function constraintSql(TableSchema $schema, $name)
- {
- $data = $schema->getConstraint($name);
- if ($data['type'] === TableSchema::CONSTRAINT_PRIMARY) {
- $columns = array_map(
- [$this->_driver, 'quoteIdentifier'],
- $data['columns']
- );
- return sprintf('PRIMARY KEY (%s)', implode(', ', $columns));
- }
- $out = '';
- if ($data['type'] === TableSchema::CONSTRAINT_UNIQUE) {
- $out = 'UNIQUE KEY ';
- }
- if ($data['type'] === TableSchema::CONSTRAINT_FOREIGN) {
- $out = 'CONSTRAINT ';
- }
- $out .= $this->_driver->quoteIdentifier($name);
- return $this->_keySql($out, $data);
- }
- /**
- * {@inheritDoc}
- */
- public function addConstraintSql(TableSchema $schema)
- {
- $sqlPattern = 'ALTER TABLE %s ADD %s;';
- $sql = [];
- foreach ($schema->constraints() as $name) {
- $constraint = $schema->getConstraint($name);
- if ($constraint['type'] === TableSchema::CONSTRAINT_FOREIGN) {
- $tableName = $this->_driver->quoteIdentifier($schema->name());
- $sql[] = sprintf($sqlPattern, $tableName, $this->constraintSql($schema, $name));
- }
- }
- return $sql;
- }
- /**
- * {@inheritDoc}
- */
- public function dropConstraintSql(TableSchema $schema)
- {
- $sqlPattern = 'ALTER TABLE %s DROP FOREIGN KEY %s;';
- $sql = [];
- foreach ($schema->constraints() as $name) {
- $constraint = $schema->getConstraint($name);
- if ($constraint['type'] === TableSchema::CONSTRAINT_FOREIGN) {
- $tableName = $this->_driver->quoteIdentifier($schema->name());
- $constraintName = $this->_driver->quoteIdentifier($name);
- $sql[] = sprintf($sqlPattern, $tableName, $constraintName);
- }
- }
- return $sql;
- }
- /**
- * {@inheritDoc}
- */
- public function indexSql(TableSchema $schema, $name)
- {
- $data = $schema->getIndex($name);
- $out = '';
- if ($data['type'] === TableSchema::INDEX_INDEX) {
- $out = 'KEY ';
- }
- if ($data['type'] === TableSchema::INDEX_FULLTEXT) {
- $out = 'FULLTEXT KEY ';
- }
- $out .= $this->_driver->quoteIdentifier($name);
- return $this->_keySql($out, $data);
- }
- /**
- * Helper method for generating key SQL snippets.
- *
- * @param string $prefix The key prefix
- * @param array $data Key data.
- * @return string
- */
- protected function _keySql($prefix, $data)
- {
- $columns = array_map(
- [$this->_driver, 'quoteIdentifier'],
- $data['columns']
- );
- foreach ($data['columns'] as $i => $column) {
- if (isset($data['length'][$column])) {
- $columns[$i] .= sprintf('(%d)', $data['length'][$column]);
- }
- }
- if ($data['type'] === TableSchema::CONSTRAINT_FOREIGN) {
- return $prefix . sprintf(
- ' FOREIGN KEY (%s) REFERENCES %s (%s) ON UPDATE %s ON DELETE %s',
- implode(', ', $columns),
- $this->_driver->quoteIdentifier($data['references'][0]),
- $this->_convertConstraintColumns($data['references'][1]),
- $this->_foreignOnClause($data['update']),
- $this->_foreignOnClause($data['delete'])
- );
- }
- return $prefix . ' (' . implode(', ', $columns) . ')';
- }
- }
|