Работа с миграциями в проектах Laravel

Расширенные примеры миграций

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

Пример 1. Миграция с внешним ключом

// create_posts_table.php
<?

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

class CreatePostsTable extends Migration
{
    public function up()
    {
        Schema::create('posts', function (Blueprint $table) {
            $table->id();
            $table->string('title', 255);
            $table->text('body');
            $table->foreignId('user_id')->constrained()->onDelete('cascade');
            $table->timestamps();
        });
    }

    public function down()
    {
        Schema::dropIfExists('posts');
    }
}

Выполнение: php artisan migrate
Результат: Создана таблица posts. В ней столбец user_id с внешним ключом на таблицу users. При удалении пользователя все его посты удаляются (cascade).

Пример 2. Изменение существующей таблицы (добавление столбца)

// add_excerpt_to_posts_table.php
<?

class AddExcerptToPostsTable extends Migration
{
    public function up()
    {
        Schema::table('posts', function (Blueprint $table) {
            $table->string('excerpt', 100)->nullable()->after('body');
        });
    }

    public function down()
    {
        Schema::table('posts', function (Blueprint $table) {
            $table->dropColumn('excerpt');
        });
    }
}

Выполнение: php artisan migrate
Результат: В таблицу posts добавлен столбец excerpt (nullable, после body). При откате столбец удаляется.

Пример 3. Миграция с использованием raw SQL

// create_views_count_view.php
<?

use Illuminate\Support\Facades\DB;

class CreateViewsCountView extends Migration
{
    public function up()
    {
        DB::statement("CREATE VIEW post_views AS SELECT post_id, COUNT(*) as views FROM post_views_table GROUP BY post_id");
    }

    public function down()
    {
        DB::statement("DROP VIEW IF EXISTS post_views");
    }
}

Выполнение: php artisan migrate
Результат: Создано представление post_views. Откат удаляет его.

Пример 4. Миграция с сидированием (одновременный запуск)

// Использование --seed с классом
php artisan migrate --seed --class=PostSeeder

Команда выполнит все ожидающие миграции, затем запустит PostSeeder. Вывод:
Migrating: 2023_01_01_000001_create_posts_table
Migrated:  2023_01_01_000001_create_posts_table (0.02 seconds)
Seeding: PostSeeder
Seeded:  PostSeeder (0.5 seconds)

Пример 5. Откат на определенное количество шагов

php artisan migrate:rollback --step=3

Откатываются 3 последних батча (группы) миграций. Вывод покажет каждую откатываемую миграцию.
Rolling back: 2023_01_01_000003_add_views_to_posts
Rolled back:  2023_01_01_000003_add_views_to_posts (0.01 seconds)
...

Пример 6. Запуск миграций из пользовательского каталога

php artisan migrate --path=/app/Modules/Admin/Database/Migrations

Будут применены миграции из указанной директории. Это удобно для модульных структур. Путь должен быть абсолютным или относительно корня проекта.

Пример 7. Имитация миграции (pretend) с выводом SQL

php artisan migrate --pretend

Пример вывода:
- Create table: posts (id, title, body, user_id, created_at, updated_at)
- Add foreign key: posts.user_id -> users.id

Команда не изменяет базу данных, только показывает планируемые операции.

Пример 8. Программный вызов миграции из кода

// В любом классе (например, команде Artisan)
\Illuminate\Support\Facades\Artisan::call('migrate', [
    '--force' => true,
    '--seed' => true,
    '--database' => 'mysql_secondary',
]);
$output = \Illuminate\Support\Facades\Artisan::output();

Результат: миграция выполняется программно. Переменная $output содержит текст вывода. Используется в автоматизированных скриптах.