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

Введение

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

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

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

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

Первый параметр метода create – имя таблицы, а второй – функция-замыкание, которое получает объект Blueprint, использующийся для определения таблицы.

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

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

Для указания иного использующегося подключения к БД используется метод Schema::connection:

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

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

Schema::drop('users');

Schema::dropIfExists('users');

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

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

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

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

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

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

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

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

Для переименования поля можно использовать метод renameColumn. Переименование возможно только при подключенном пакете doctrine/dbal в composer.json.

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

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

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

Для удаления поля можно использовать метод dropColumn. Удаление возможно только при подключенном пакете doctrine/dbal в composer.json.

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

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

Удаление сразу нескольких полей

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

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

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

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

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

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

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

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

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

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

$table->unique('email');

Ниже список всех доступных типов индексов.

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

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

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

В этом примере мы указываем, что поле user_id связано с полем id таблицы users. Обратите внимание, что поле user_id должно существовать перед определением ключа.

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

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

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

$table->dropForeign('posts_user_id_foreign');

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

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

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

Удаление столбцов дат создания и псевдоудаления

Для того, чтобы удалить столбцы created_at , updated_at и deleted_at, которые создаются методами timestamps (или nullableTimestamps) и softDeletes, вы можете использовать следующие методы:

Storage Engines (системы хранения)

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

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

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

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