Миграции Laravel на рабочем сайте: migrate --force и откат
Миграции — файлы в папке database/migrations проекта: каждый описывает, какую таблицу или столбец создать в базе. Команда php artisan migrate выполняет те, что ещё не выполнялись, и записывает их в служебную таблицу migrations. На рабочем сайте Laravel переспрашивает перед запуском, а несколько команд стирают данные. Ниже — какие команды запускать, как проверить и как откатить.
Содержание 13
Что сделать прямо сейчас
- Перейдите в папку проекта:
cd /var/www/example.com. - Посмотрите, какие миграции ещё не выполнены:
sudo -u www-data php artisan migrate:status. - Сделайте копию базы — команда ниже.
- Выполните миграции:
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 --pretendLaravel покажет запросы, которые выполнил бы, но в базе ничего не изменит. Так можно проверить, нет ли среди них 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.
Источники
- Документация Laravel: Migrations — на английском: migrate, --force, --pretend, --step, --isolated, rollback и migrate:fresh.
- Исходный код команды migrate в Laravel 13.42.0 — на английском: ключи и сообщения о несуществующей базе.
- Исходный код команды migrate:status в Laravel 13.42.0 — на английском: колонки Ran и Pending.
- Исходный код ConfirmableTrait в Laravel 13.42.0 — на английском: вопрос перед запуском в production.
- Коды SQLSTATE в PHP 8.3.6 — на английском: тексты 42S01 и 42S02.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Laravel на серверевсе статьи о работе проекта на VPS.
- Выкладка обновленийгде миграции стоят в порядке команд.
- mysqldumpкопия базы MySQL одной командой.