Конструктор таблиц

Данная статья документации актуальна только для версии 5.0 и была удалена в версии 5.1.

Введение

В Laravel, класс PHPSchema представляет собой независимый от БД интерфейс манипулирования таблицами. Он хорошо работает со всеми СУБД, поддерживаемыми Laravel, и предоставляет унифицированный API для любой из этих систем.

Создание и удаление таблиц

Для создания новой таблицы используется метод PHPSchema::create():

Schema::create('users', function($table)
{
  $table->increments('id');
});

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

Чтобы переименовать существующую таблицу используется метод PHPrename():

Schema::rename($from, $to);

Для указания того, какое подключение к БД должно использоваться для выполнения операции, используется метод PHPSchema::connection():

Schema::connection('foo')->create('users', function($table)
{
  $table->increments('id');
});

Для удаления таблицы вы можете использовать метод PHPSchema::drop():

Schema::drop('users');

Schema::dropIfExists('users');

Добавление полей

Для обновления существующей таблицы мы будем использовать метод PHPSchema::table():

Schema::table('users', function($table)
{
  $table->string('email');
});

Конструктор таблиц поддерживает различные типы полей, которые вы можете использовать при создании таблиц:

Вставка поля после существующего в MySQL

Если вы используете MySQL, то метод PHPafter() позволит вам вставить поле после определённого существующего поля:

$table->string('name')->after('email');

Изменение полей

Внимание: Перед изменением полей не забудьте добавить зависимость doctrine/dbal в свой файл composer.json.

Иногда необходимо изменить существующее поле. Например, если надо увеличить размер строкового поля. С методом PHPchange() это легко! Давайте увеличим размер поля name с 25 до 50:

Schema::table('users', function($table)
{
  $table->string('name', 50)->change();
});

Также мы можем сделать поле обнуляемым (nullable):

Schema::table('users', function($table)
{
  $table->string('name', 50)->nullable()->change();
});

Переименование полей

Для переименования поля можно использовать метод PHPrenameColumn() объекта конструктора. Перед переименованием полей не забудьте добавить зависимость doctrine/dbal в ваш файл composer.json.

Schema::table('users', function($table)
{
  $table->renameColumn('from', 'to');
});

Внимание: Переименование полей типа ENUM не поддерживается.

Удаление полей

Для удаления поля можно использовать метод конструктора таблиц PHPdropColumn(). Перед удалением поля убедитесь, что в файл composer.json добавлена зависимость confdoctrine/dbal.

Удаление одного поля из таблицы

Schema::table('users', function($table)
{
  $table->dropColumn('votes');
});

Удаление нескольких полей таблицы

Schema::table('users', function($table)
{
  $table->dropColumn(['votes', 'avatar', 'location']);
});

Проверка на существование

Вы можете легко проверить существование таблицы или поля с помощью методов PHPhasTable() и PHPhasColumn().

Проверка существования таблицы

if (Schema::hasTable('users'))
{
  //
}

Проверка существования поля

if (Schema::hasColumn('users', 'email'))
{
  //
}

Добавление индексов

Конструктор таблиц поддерживает несколько типов индексов. Есть два способа добавлять индексы. Первый — определять их на самих полях, либо добавлять отдельно:

$table->string('email')->unique();

Или вы можете добавлять их отдельными строками. Ниже список всех доступных типов индексов:

Внешние ключи

Laravel поддерживает добавление внешних ключей (foreign key constraints) для ваших таблиц:

$table->integer('user_id')->unsigned();
$table->foreign('user_id')->references('id')->on('users');

В этом примере мы указываем, что поле user_id связано с полем id таблицы users. Не забудьте сначала создать поле для внешних ключей!

Вы также можете задать действия, происходящие при обновлении (on update) и удалении (on delete) записей:

$table->foreign('user_id')
      ->references('id')->on('users')
      ->onDelete('cascade');

Для удаления внешнего ключа используется метод PHPdropForeign(). Схема именования ключей — та же, что и для индексов:

$table->dropForeign('posts_user_id_foreign');

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

Удаление индексов

Для удаления индекса вы должны указать его имя. По умолчанию Laravel присваивает каждому индексу осознанное имя. Просто объедините имя таблицы, имена всех его полей и добавьте тип индекса. Вот несколько примеров:

Удаление полей Timestamps и SoftDeletes

Для удаления полей с типами PHPtimestamps, PHPnullableTimestamps и PHPsoftDeletes используйте следующие методы:

Системы хранения

Для задания конкретной системы хранения таблицы задайте свойство PHPengine конструктора таблиц:

Schema::create('users', function($table)
{
  $table->engine = 'InnoDB';

  $table->string('email');
});

Система хранения — тип архитектуры таблицы. Некоторые СУБД поддерживают только свой встроенный тип (такие, как SQLite), в то время другие — например, MySQL — позволяют использовать различные системы даже внутри одной БД (наиболее используемыми являются MyISAM, InnoDB и MEMORY). Правда, использование таблиц различных архитектур в одном запросе заметно снижает его производительность — прим. пер.