Как добавить новое поле в существующую таблицу через миграцию в Laravel?

Правильный способ добавления нового поля в существующую таблицу

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

Шаг 1: Создание новой миграции

Вы сделали правильно — создали отдельную миграцию через Artisan:

php artisan make:migration add_phone_to_users_table

Шаг 2: Правильная структура метода up()

В методе up() нужно использовать Schema::table(). Но есть важный момент: если поле должно быть необязательным (nullable), обязательно укажите это:

<?php

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

return new class extends Migration
{
    public function up(): void
    {
        Schema::table('users', function (Blueprint $table) {
            $table->string('phone', 20)->nullable()->after('email');
        });
    }

    public function down(): void
    {
        Schema::table('users', function (Blueprint $table) {
            $table->dropColumn('phone');
        });
    }
};

Почему ваша миграция не работала?

Скорее всего, проблема в том, что вы не указали nullable(). Если поле NOT NULL, а в таблице уже есть строки, MySQL выдаст ошибку. Но вы сказали, что ошибки не было — значит, проблема в другом. Возможные причины:

• Кэш миграций — попробуйте выполнить php artisan optimize:clear перед запуском
• Не та база данных — проверьте файл .env, возможно, миграция применяется к другой БД
• Миграция уже была выполнена — проверьте таблицу migrations в БД, возможно, запись уже есть

Шаг 3: Запуск миграции

php artisan migrate

Если нужно откатить последнюю миграцию и выполнить заново:

php artisan migrate:rollback --step=1
php artisan migrate

Дополнительные советы

• Используйте ->after('column_name'), чтобы указать, после какой колонки добавить новое поле
• Для добавления нескольких полей просто перечисляйте их внутри замыкания:

Schema::table('users', function (Blueprint $table) {
    $table->string('phone', 20)->nullable();
    $table->date('birthdate')->nullable();
    $table->boolean('is_active')->default(true);
});

Проверка результата

После успешного выполнения миграции проверьте структуру таблицы через Tinker:

php artisan tinker
> Schema::hasColumn('users', 'phone');
=> true

Если всё равно не работает — попробуйте создать миграцию с явным указанием имени класса (без анонимного класса), это иногда решает проблемы с кэшированием.

php artisan make:migration add_phone_to_users_table --table=users

public function up(): void
{
    Schema::table('users', function (Blueprint $table) {
        $table->string('phone', 20)->nullable();
    });
}

php artisan migrate:status

php artisan migrate --force

php artisan migrate --pretend