You are here

public function Schema::renameTable in Drupal 10

Same name in this branch
  1. 10 core/lib/Drupal/Core/Database/Schema.php \Drupal\Core\Database\Schema::renameTable()
  2. 10 core/modules/sqlite/src/Driver/Database/sqlite/Schema.php \Drupal\sqlite\Driver\Database\sqlite\Schema::renameTable()
  3. 10 core/modules/pgsql/src/Driver/Database/pgsql/Schema.php \Drupal\pgsql\Driver\Database\pgsql\Schema::renameTable()
  4. 10 core/modules/mysql/src/Driver/Database/mysql/Schema.php \Drupal\mysql\Driver\Database\mysql\Schema::renameTable()
  5. 10 core/tests/fixtures/database_drivers/module/corefake/src/Driver/Database/corefakeWithAllCustomClasses/Schema.php \Drupal\corefake\Driver\Database\corefakeWithAllCustomClasses\Schema::renameTable()

Rename a table.

Parameters

$table: The table to be renamed.

$new_name: The new name for the table.

Throws

\Drupal\Core\Database\SchemaObjectDoesNotExistException If the specified table doesn't exist.

\Drupal\Core\Database\SchemaObjectExistsException If a table with the specified new name already exists.

Overrides Schema::renameTable

1 call to Schema::renameTable()
Schema::alterTable in core/modules/sqlite/src/Driver/Database/sqlite/Schema.php
Create a table with a new schema containing the old content.

File

core/modules/sqlite/src/Driver/Database/sqlite/Schema.php, line 267

Class

Schema
SQLite implementation of \Drupal\Core\Database\Schema.

Namespace

Drupal\sqlite\Driver\Database\sqlite

Code

public function renameTable($table, $new_name) {
  if (!$this
    ->tableExists($table)) {
    throw new SchemaObjectDoesNotExistException("Cannot rename '{$table}' to '{$new_name}': table '{$table}' doesn't exist.");
  }
  if ($this
    ->tableExists($new_name)) {
    throw new SchemaObjectExistsException("Cannot rename '{$table}' to '{$new_name}': table '{$new_name}' already exists.");
  }
  $schema = $this
    ->introspectSchema($table);

  // SQLite doesn't allow you to rename tables outside of the current
  // database. So the syntax '... RENAME TO database.table' would fail.
  // So we must determine the full table name here rather than surrounding
  // the table with curly braces in case the db_prefix contains a reference
  // to a database outside of our existing database.
  $info = $this
    ->getPrefixInfo($new_name);
  $this->connection
    ->query('ALTER TABLE {' . $table . '} RENAME TO ' . $info['table']);

  // Drop the indexes, there is no RENAME INDEX command in SQLite.
  if (!empty($schema['unique keys'])) {
    foreach ($schema['unique keys'] as $key => $fields) {
      $this
        ->dropIndex($table, $key);
    }
  }
  if (!empty($schema['indexes'])) {
    foreach ($schema['indexes'] as $index => $fields) {
      $this
        ->dropIndex($table, $index);
    }
  }

  // Recreate the indexes.
  $statements = $this
    ->createIndexSql($new_name, $schema);
  foreach ($statements as $statement) {
    $this->connection
      ->query($statement);
  }
}