Поиск
Справочник

Миграции Laravel на рабочем сайте: migrate --force и откат

Миграции — файлы в папке database/migrations проекта: каждый описывает, какую таблицу или столбец создать в базе. Команда php artisan migrate выполняет те, что ещё не выполнялись, и записывает их в служебную таблицу migrations. На рабочем сайте Laravel переспрашивает перед запуском, а несколько команд стирают данные. Ниже — какие команды запускать, как проверить и как откатить.

≈ 6 мин чтения
Содержание 13

Что сделать прямо сейчас

  1. Перейдите в папку проекта: cd /var/www/example.com.
  2. Посмотрите, какие миграции ещё не выполнены: sudo -u www-data php artisan migrate:status.
  3. Сделайте копию базы — команда ниже.
  4. Выполните миграции: sudo -u www-data php artisan migrate --force.

Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Проект в примерах лежит в /var/www/example.com, база MySQL называется example.

Как выполнить миграции

cd /var/www/example.com
sudo -u www-data php artisan migrate --force

Ответ начинается строкой Running migrations., дальше по строке на каждую миграцию с пометкой DONE. Если новых миграций нет — Nothing to migrate. Это не ошибка: база уже в нужном виде.

Почему нужен --force

Когда в .env стоит APP_ENV=production, Laravel перед миграцией выводит предупреждение Application In Production и спрашивает:

Are you sure you want to run this command?

По умолчанию выбран ответ «нет». Если просто нажать Enter, Laravel ответит Command cancelled. и ничего не сделает. Ключ --force отвечает «да» заранее — так миграции работают в скрипте выкладки, где спрашивать некого.

Как посмотреть, что выполнено

sudo -u www-data php artisan migrate:status

Команда покажет две колонки: Migration name — имя файла миграции и Batch / Status — состояние.

В колонке Batch / StatusЧто значит
[1] Ranмиграция выполнена, в квадратных скобках — номер партии
Pendingмиграция ещё не выполнена

Партия — это все миграции, выполненные одним запуском migrate. Откат возвращает назад сразу всю последнюю партию.

Показать только невыполненные: sudo -u www-data php artisan migrate:status --pending. Ответ No pending migrations. — всё выполнено.

Посмотреть SQL до запуска

sudo -u www-data php artisan migrate --pretend

Laravel покажет запросы, которые выполнил бы, но в базе ничего не изменит. Так можно проверить, нет ли среди них drop table или drop column — они удаляют данные.

Копия базы перед миграцией

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

mkdir -p ~/backup
sudo mysqldump --single-transaction --routines --events example > ~/backup/example.sql

Вернуть базу из копии:

sudo mysql example < ~/backup/example.sql

Подробнее — mysqldump и Резервные копии сайта.

Как откатить

sudo -u www-data php artisan migrate:rollback --force

Команда отменяет последнюю партию миграций: выполняет в каждом файле часть down. Ответ начинается строкой Rolling back migrations. Если откатывать нечего — Nothing to rollback.

КомандаЧто откатит
migrate:rollbackпоследнюю партию
migrate:rollback --step=1одну последнюю миграцию
migrate:rollback --batch=3партию номер 3
migrate:rollback --pretendничего — только покажет SQL

Откат тоже удаляет данные: если миграция создала таблицу, откат её удалит вместе со строками. Сначала посмотрите SQL с --pretend и сделайте копию базы.

Чтобы потом откатывать миграции по одной, выполняйте их с ключом --step: migrate --force --step записывает каждую миграцию в свою партию.

Команды, которые стирают данные

КомандаЧто делает
migrate:freshудаляет все таблицы базы и создаёт их заново пустыми
migrate:refreshоткатывает все миграции и выполняет их заново
migrate:resetоткатывает все миграции

Эти команды нужны при разработке. На рабочем сайте их не запускайте: после них в базе не останется ни пользователей, ни заказов. Если команда ответила This command is prohibited from running in this environment., значит в проекте включён запрет таких команд — это защита, так и задумано. Запрет действует и на migrate:rollback.

Если серверов несколько

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

sudo -u www-data php artisan migrate --force --isolated

Кеш должен быть общим для всех серверов — например, одна база данных или один Redis.

Если базы ещё нет

Если запустить миграции без --force, Laravel сначала напишет, что базы нет:

Ответ LaravelЧто произошло
The database 'example' does not exist on the 'mysql' connection.в MySQL нет базы с именем из DB_DATABASE
The SQLite database configured for this application does not exist: …нет файла базы SQLite

Затем он спросит Would you like to create it? и создаст базу, если ответить «да». С ключом --force Laravel ничего не пишет и не спрашивает — сразу пытается создать базу сам. Для MySQL у пользователя базы должно быть право создавать базы, поэтому надёжнее создать базу и пользователя заранее — Установка MySQL.

Ошибки и как их исправить

Что видитеПричинаЧто делать
Command cancelled.APP_ENV=production, а ключа --force нетдобавьте --force
Migration table not found.миграции на этой базе ещё не выполнялисьsudo -u www-data php artisan migrate --force
The database 'example' does not exist on the 'mysql' connection.нет базысоздайте базу
SQLSTATE[42S01]: Base table or view already existsтаблица уже есть, а записи в migrations нетне удаляйте таблицу с данными — покажите ошибку разработчику
SQLSTATE[42S02]: Base table or view not foundмиграции не выполненыsudo -u www-data php artisan migrate --force
SQLSTATE[HY000] [2002]MySQL не запущен или неверный DB_HOSTРазбор
SQLSTATE[HY000] [1045] Access denied for userневерный логин или пароль базыРазбор
could not find driverнет модуля PHP для базыРазбор
This command is prohibited from running in this environment.в проекте запрещены команды, которые стирают данныена рабочем сайте эти команды не нужны

Тексты сообщений сверены по исходному коду Laravel 13.42.0 и PHP 8.3.6.

Источники

Сверено 13 ноября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше