пользователей: 30398
предметов: 12406
вопросов: 234839
Конспект-online
 РЕГИСТРАЦИЯ ЭКСКУРСИЯ

Миграции баз данных. Migration

Миграции

 

  1. 1. Введение
  2. 2. Создание миграций
  3. 3. Структура миграций
  4. 4. Выполнение миграций
    1. 4.1. Откат миграций
  5. 5. Создание миграций
  6. 5.1. Создание таблиц
  7. 5.2. Переименование/удаление таблиц
  8. 5.3. Создание столбцов
  9. 5.4. Изменение столбцов
  10. 5.5. Удаление столбцов
  11. 5.6. Создание индексов
  12. 5.7. Удаление индексов
  13. 5.8. Ограничения внешнего ключа
  14. 6. Загрузка начальных данных в БД

Этот перевод актуален для англоязычной документации на 08.12.2016 (ветка 5.2) , 19.06.2016 (ветка 5.1) и 31.07.2015 (ветка 5.0). Опечатка? Выдели и нажми Ctrl+Enter.

Введение

Миграции — что-то вроде системы контроля версий для вашей базы данных. Они позволяют команде изменять её структуру, в то же время оставаясь в курсе изменений других участников. Миграции обычно идут рука об руку с построителем структур для более простого обращения с архитектурой вашей базы данных.

Фасад Laravel Schema обеспечивает поддержку создания и изменения таблиц в независимости от используемой БД. Он предоставляет единый, выразительный и гибкий API для всех поддерживаемых в Laravel СУБД.

Создание миграций

Для создания новой миграции используйте Artisan-команду make:migration:

php artisan make:migration create_users_table

Миграция будет помещена в папку database/migrations и будет содержать метку времени, которая позволяет фреймворку определять порядок применения миграций.

Можно также использовать параметры --table и --create для указания имени таблицы и того факта, что миграция будет создавать новую таблицу (а не изменять существующую — прим. пер.). Эти параметры просто заранее создают указанную таблицу в создаваемом файле-заглушке миграции:

php artisan make:migration add_votes_to_users_table --table=users

 

php artisan make:migration create_users_table --create=users

Если вы хотите указать свой путь для сохранения создаваемых миграций, используйте параметр --path при запуске команды make:migration. Этот путь должен быть указан относительно базового пути вашего приложения.

Структура миграций

Класс миграций содержит два метода: up() и down(). Метод up() используется для добавления новых таблиц, столбцов или индексов в вашу БД, а метод down() просто отменяет операции, выполненные методом up().

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

<?php

use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;

class CreateFlightsTable extends Migration
{
  /**
   * Выполнение миграций.
   *
   * @return void
   */
  public function up()
  {
    Schema::create('flights', function (Blueprint $table) {
      $table->increments('id');
      $table->string('name');
      $table->string('airline');
      $table->timestamps();
    });
  }

  /**
   * Отмена миграций.
   *
   * @return void
   */
  public function down()
  {
    Schema::drop('flights');
  }
}

Выполнение миграций

Для запуска всех необходимых миграций для вашего приложения используйте Artisan-команду migrate. Если вы используете виртуальную машину Homestead, вам надо выполнить эту команду на ВМ:

php artisan migrate

Если при применении миграции вы получаете ошибку «class not found» («класс не найден»), попробуйте выполнить команду composer dump-autoload и заново запустить команду migrate.

Принудительные миграции в продакшне

Некоторые операции миграций разрушительны, они могут привести к потере ваших данных. Для предотвращения случайного запуска этих команд на вашей боевой БД перед их выполнением запрашивается подтверждение. Для принудительного запуска команд без подтверждения используйте ключ --force:

php artisan migrate --force

Откат миграций

Для отмены изменений, сделанных последней миграцией, используйте команду rollback. Учтите, что эта команда отменит результат последней «партии» миграций, которая может включать несколько файлов миграций:

php artisan migrate:rollback

Команда migrate:reset отменит изменения всех миграций вашего приложения:

php artisan migrate:reset

Откат всех миграций и их повторное применение одной командой

Команда migrate:refresh cначала отменит изменения всех миграций вашей БД, а затем выполнит команду migrate. Эта команда эффективно создаёт заново всю вашу БД:

php artisan migrate:refresh

 

php artisan migrate:refresh --seed

Создание миграций

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

Для создания новой таблицы БД используйте метод create() фасада Schema. Метод create() принимает два аргумента. Первый — имя таблицы, второй — замыкание, которое получает объект Blueprint, используемый для определения новой таблицы:

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

Само собой, при создании таблицы вы можете использовать любые методы для работы со столбцами построителя структур.

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

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

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

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

Подключение и подсистема хранения данных

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

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

Чтобы задать подсистему хранения данных для таблицы, задайте свойство engine для построителя структур:

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

  $table->increments('id');
});

Переименование/удаление таблиц

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

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

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

Schema::drop('users');

Schema::dropIfExists('users');

+ 5.2

добавлено в 5.2 (08.12.2016)

Переименование таблиц с внешними ключами

Перед переименованием таблицы вы должны проверить, что для всех ограничений внешних ключей таблицы есть явные имена в файлах вашей миграции, чтобы избежать автоматического назначения имён на основе принятого соглашения. Иначе имя ограничения внешнего ключа будет ссылаться на имя старой таблицы.

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

Для изменения существующей таблицы мы будем использовать метод table() фасада Schema. Как и метод create(), метод table() принимает два аргумента: имя таблицы и замыкание, которое получает экземпляр Blueprint, который мы можем использовать для добавления столбцов в таблицу:

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

Доступные типы столбцов

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

Команда

Описание

$table->bigIncrements('id');

Инкрементный ID (первичный ключ), использующий эквивалент "UNSIGNED BIG INTEGER"

$table->bigInteger('votes');

Эквивалент BIGINT для базы данных

$table->binary('data');

Эквивалент BLOB для базы данных

$table->boolean('confirmed');

Эквивалент BOOLEAN для базы данных

$table->char('name', 4);

Эквивалент CHAR для базы данных

$table->date('created_at');

Эквивалент DATE для базы данных

$table->dateTime('created_at');

Эквивалент DATETIME для базы данных

$table->dateTimeTz('created_at');

Эквивалент DATETIME (с часовым поясом) для базы данных (для версии 5.2 и выше)

$table->decimal('amount', 5, 2);

Эквивалент DECIMAL с точностью и масштабом

$table->double('column', 15, 8);

Эквивалент DOUBLE с точностью, всего 15 цифр, после запятой 8 цифр

$table->enum('choices', ['foo', 'bar']);

Эквивалент ENUM для базы данных

$table->float('amount');

Эквивалент FLOAT для базы данных

$table->increments('id');

Инкрементный ID (первичный ключ), использующий эквивалент "UNSIGNED INTEGER"

$table->integer('votes');

Эквивалент INTEGER для базы данных

$table->ipAddress('visitor');

Эквивалент IP-адреса для базы данных (для версии 5.2 и выше)

$table->json('options');

Эквивалент JSON для базы данных

$table->jsonb('options');

Эквивалент JSONB для базы данных

$table->longText('description');

Эквивалент LONGTEXT для базы данных

$table->macAddress('device');

Эквивалент MAC-адреса для базы данных (для версии 5.2 и выше)

$table->mediumInteger('numbers');

Эквивалент MEDIUMINT для базы данных

$table->mediumText('description');

Эквивалент MEDIUMTEXT для базы данных

$table->morphs('taggable');

Добавление столбца taggable_id INTEGER и taggable_type STRING

$table->nullableTimestamps();

Аналогично timestamps(), но разрешено значение NULL

$table->rememberToken();

Добавление столбца remember_token VARCHAR(100) NULL

$table->smallInteger('votes');

Эквивалент SMALLINT для базы данных

$table->softDeletes();

Добавление столбца deleted_at для мягкого удаления

$table->string('email');

Эквивалент VARCHAR

$table->string('name', 100);

Эквивалент VARCHAR с длинной

$table->text('description');

Эквивалент TEXT для базы данных

$table->time('sunrise');

Эквивалент TIME для базы данных

$table->timeTz('sunrise');

Эквивалент TIME (с часовым поясом) для базы данных (для версии 5.2 и выше)

$table->tinyInteger('numbers');

Эквивалент TINYINT для базы данных

$table->timestamp('added_on');

Эквивалент TIMESTAMP для базы данных

$table->timestampTz('added_on');

Эквивалент TIMESTAMP (с часовым поясом) для базы данных (для версии 5.2 и выше)

$table->timestamps();

Добавление столбцов created_at и updated_at

$table->uuid('id');

Эквивалент UUID для базы данных

Модификаторы столбцов

Вдобавок к перечисленным типам столбцов существует несколько других «модификаторов» столбцов, которые вы можете использовать при добавлении столбцов. Например, чтобы сделать столбец «обнуляемым», используйте метод nullable():

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

Ниже перечислены все доступные модификаторы столбцов. В этом списке отсутствуют модификаторы индексов:

Модификатор

Описание

->first()

Помещает столбец "первым" в таблице (только MySQL)

->after('column')

Помещает столбец "после" указанного столбца (только MySQL)

->nullable()

Разрешает вставлять значения NULL в столбец

->default($value)

Указывает значение "по умолчанию" для столбца

->unsigned()

Делает столбцы integer беззнаковыми UNSIGNED

->comment('my comment')

Добавляет комментарий в столбец (для версии 5.2 и выше)

Изменение столбцов

Требования

Перед изменением столбцов добавьте зависимость doctrine/dbal в свой файл composer.json. Библиотека Doctrine DBAL используется для определения текущего состояния столбца и создания SQL-запросов, необходимых для выполнения указанных преобразований столбца.

Изменение атрибутов столбца

Метод change() позволяет изменить тип существующего столбца или изменить его атрибуты. Например, если вы захотите увеличить размер строкового столбца name с 25 до 50:

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

Также мы можем изменить столбец, чтобы он стал «обнуляемым»:

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

+ 5.2

добавлено в 5.2 (08.12.2016)

Пока не поддерживается изменение любых столбцов в таблице, содержащей столбцы типов enum, json или jsonb.

Переименование столбцов

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

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

Пока не поддерживается переименование любых столбцов в таблице, содержащей столбцы типов enum, json или jsonb.

Удаление столбцов

Для удаления столбца используйте метод dropColumn() на построителе структур:

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

Вы можете удалить несколько столбцов таблицы, передав массив их имён в метод dropColumn():

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

Перед удалением столбцов из базы данных SQLite вам необходимо добавить зависимость doctrine/dbal в ваш файл composer.json и выполнить команду composer update для установки библиотеки.

Удаление и изменение нескольких столбцов одной миграцией не поддерживается для базы данных SQLite.

Создание индексов

Построитель структур поддерживает несколько типов индексов. Сначала давайте посмотрим на пример, в котором задаётся, что значения столбца должны быть уникальными. Для создания индекса мы можем просто сцепить метод unique() с определением столбца:

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

Другой вариант — создать индекс после определения столбца. Например:

$table->unique('email');

Вы можете даже передать массив столбцов в метод index() для создания сложного индекса:

$table->index(['account_id', 'created_at']);

+ 5.2

добавлено в 5.2 (08.12.2016)

Laravel автоматически генерирует подходящее имя индекса, но вы можете передать своё значение вторым аргументом метода:

$table->index('email', 'my_index_name');

Доступные типы индексов

Команда

Описание

$table->primary('id');

Добавление первичного ключа

$table->primary(['first', 'last']);

Добавление составных ключей

$table->unique('email');

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

$table->unique('state', 'my_index_name');

Добавление своего имени индекса (для версии 5.2 и выше)

$table->index('state');

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

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

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

Команда

Описание

$table->dropPrimary('users_id_primary');

Удаление первичного ключа из таблицы "users"

$table->dropUnique('users_email_unique');

Удаление уникального индекса из таблицы "users"

$table->dropIndex('geo_state_index');

Удаление базового индекса из таблицы "geo"

Если вы передадите массив столбцов в метод для удаления индексов, будет сгенерировано стандартное имя индекса на основе имени таблицы, столбца и типа ключа.

Schema::table('geo', function ($table) {
  $table->dropIndex(['state']); // Удаление индекса 'geo_state_index'
});

Ограничения внешнего ключа

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

Schema::table('posts', function ($table) {
    $table->integer('user_id')->unsigned();

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

Вы также можете указать требуемое действие для свойств "on delete" и "on update" ограничений:

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

Для удаления внешнего ключа используйте метод dropForeign(). Ограничения внешнего ключа используют те же принципы именования, что и индексы. Итак, мы соединим имя таблицы и столбцов из ограничения, а затем добавим суффикс "_foreign":

$table->dropForeign('posts_user_id_foreign');

Или вы можете передать значение массива, при этом для удаления будет автоматически использовано стандартное имя ограничения:

$table->dropForeign(['user_id']);

+ 5.2

добавлено в 5.2 (08.12.2016)

Вы можете включить или выключить ограничения внешнего ключа в своих миграциях с помощью следующих методов:

Schema::enableForeignKeyConstraints();

Schema::disableForeignKeyConstraints();

+ 5.0

добавлено в 5.0 (08.02.2016)

Загрузка начальных данных в БД

Кроме миграций, описанных выше, Laravel также включает в себя механизм наполнения вашей БД начальными данными (seeding) с помощью специальных классов. Все такие классы хранятся в database/seeds. Они могут иметь любое имя, но вам, вероятно, следует придерживаться какой-то логики в их именовании — например, UserTableSeeder и т.д. По умолчанию для вас уже определён класс DatabaseSeeder. Из этого класса вы можете вызывать метод call() для подключения других классов с данными, что позволит вам контролировать порядок их выполнения.

Пример класса для загрузки начальных данных

class DatabaseSeeder extends Seeder {

  public function run()
  {
    $this->call('UserTableSeeder');

    $this->command->info('Таблица пользователей загружена данными!');
  }

}

class UserTableSeeder extends Seeder {

  public function run()
  {
    DB::table('users')->delete();

    User::create(['email' => 'foo@bar.com']);
  }

}

Для добавления данных в БД используйте Artisan-команду db:seed:

php artisan db:seed

По умолчанию команда db:seed вызывает класс DatabaseSeeder, который может быть использован для вызова других классов, заполняющих БД данными. Однако, вы можете использовать параметр --class для указания конкретного класса для вызова:

php artisan db:seed --class=UserTableSeeder

Вы также можете использовать для заполнения БД данными команду %%(sh)migrate:refresh**, которая также откатит и заново применит все ваши миграции:

php artisan migrate:refresh --seed

 

22.06.2017; 18:49
хиты: 149
рейтинг:0
для добавления комментариев необходимо авторизироваться.
  Copyright © 2013-2024. All Rights Reserved. помощь