Выкладка обновлений Laravel на сервер: порядок команд
Новый код мало забрать из Git: Laravel нужно поставить новые пакеты, обновить таблицы в базе, собрать кеш и перезапустить воркеры очереди, которые держат старый код в памяти. Если пропустить шаг, сайт работает по старому коду или отвечает ошибкой. Ниже — порядок команд, что делает каждая, и скрипт, который выполняет их по очереди.
Содержание 15
Что сделать прямо сейчас
- Сделайте резервную копию базы — как.
- Создайте файл скрипта:
nano ~/deploy.sh— и вставьте готовый скрипт. - Разрешите его запуск:
chmod +x ~/deploy.sh. - Запустите:
~/deploy.sh— и проверьте сайт в браузере.
Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Проект в примерах лежит в /var/www/example.com и загружен через git clone — Установка Laravel.
Порядок команд
cd /var/www/example.com
sudo -u www-data php artisan down --render="errors::503"
git pull --ff-only
composer install --no-dev --optimize-autoloader
sudo -u www-data php artisan migrate --force
npm install
npm run build
sudo -u www-data php artisan optimize
sudo -u www-data php artisan reload
sudo -u www-data php artisan up| Шаг | Команда | Что делает |
|---|---|---|
| 1 | php artisan down --render="errors::503" | закрывает сайт: посетители видят страницу 503 |
| 2 | git pull --ff-only | забирает новый код из репозитория |
| 3 | composer install --no-dev --optimize-autoloader | ставит пакеты PHP из файла composer.lock |
| 4 | php artisan migrate --force | обновляет таблицы в базе |
| 5 | npm install и npm run build | собирает стили и скрипты в public/build |
| 6 | php artisan optimize | собирает кеш настроек, маршрутов и шаблонов |
| 7 | php artisan reload | перезапускает воркеры очереди и планировщик |
| 8 | php artisan up | открывает сайт |
Команды Git, Composer и npm запускайте от своего пользователя — владельца папки проекта. Команды artisan — от пользователя сайта через sudo -u www-data: так новые файлы в storage и bootstrap/cache достанутся www-data, и сайт сможет их перезаписать.
1. Закройте сайт
sudo -u www-data php artisan down --render="errors::503"Ключ --render отдаёт страницу 503 до загрузки папки vendor — посетитель не увидит ошибку, пока Composer меняет пакеты. Чтобы самому видеть сайт во время работ, добавьте --with-secret. Подробнее — Режим обслуживания.
2. Заберите код
git pull --ff-onlyС ключом --ff-only Git только добавляет новые коммиты и ничего не сливает сам. Если на сервере правили файлы руками, Git остановится с ошибкой — это защищает правки от потери. Что значат ответы — в статье git pull.
3. Поставьте пакеты PHP
composer install --no-dev --optimize-autoloader| Ключ | Что значит |
|---|---|
--no-dev | не ставить пакеты для разработки из раздела require-dev |
--optimize-autoloader | составить полный список классов, чтобы PHP быстрее их находил |
Команда install ставит ровно те версии, что записаны в composer.lock. Команду composer update на рабочем сервере не запускайте: она поднимет версии пакетов, которые разработчик не проверял.
Composer запускайте от своего пользователя, не через sudo — почему.
4. Обновите базу
sudo -u www-data php artisan migrate --forceКоманда выполняет новые миграции — создаёт таблицы и столбцы, которых ещё нет. Ключ --force нужен на рабочем сайте: без него Laravel переспросит, точно ли выполнять. Перед этим шагом сделайте копию базы — mysqldump. Подробнее — Миграции на рабочем сайте.
5. Соберите стили и скрипты
Шаг нужен, если в проекте есть файл package.json и стили собирает Vite:
npm install
npm run buildГотовые файлы попадают в папку public/build. Если пропустить шаг, сайт ответит ошибкой о файле manifest — разбор. Node.js на сервере ставится по статье Установка Node.js.
6. Соберите кеш
sudo -u www-data php artisan optimizeКоманда собирает кеш настроек, событий, маршрутов и шаблонов заново — уже из нового кода. Подробнее — php artisan optimize.
7. Перезапустите воркеры
sudo -u www-data php artisan reloadОтвет начинается строкой Reloading services., дальше строки queue и schedule с пометкой DONE.
| Строка | Команда внутри | Что делает |
|---|---|---|
queue | queue:restart | воркеры доделают текущую задачу и перезапустятся с новым кодом |
schedule | schedule:interrupt | планировщик прервёт текущую минуту и начнёт следующую с новым кодом |
Воркеры перезапустятся, только если ими управляет Supervisor — Очереди и Supervisor. Пропустить одну часть можно ключом --except, например --except=schedule.
8. Откройте сайт
sudo -u www-data php artisan upОтвет: Application is now live. Проверьте главную и пару страниц в браузере.
Скрипт выкладки
Чтобы не набирать команды каждый раз, сохраните их в файл в своей домашней папке:
nano ~/deploy.shВставьте:
#!/bin/bash
set -e
cd /var/www/example.com
sudo -u www-data php artisan down --render="errors::503"
git pull --ff-only
composer install --no-dev --optimize-autoloader
sudo -u www-data php artisan migrate --force
npm install
npm run build
sudo -u www-data php artisan optimize
sudo -u www-data php artisan reload
sudo -u www-data php artisan up
echo "Готово"Сохраните: Ctrl+O, Enter, выход — Ctrl+X. Затем:
chmod +x ~/deploy.sh
~/deploy.sh| Строка | Что значит |
|---|---|
#!/bin/bash | скрипт выполняет оболочка bash |
set -e | если команда завершилась с ошибкой, скрипт остановится |
cd /var/www/example.com | все команды выполняются в папке проекта |
Если в проекте нет package.json, удалите строки с npm. Скрипт лежит в домашней папке, а не в проекте, — git pull его не перезапишет. При первом sudo система спросит ваш пароль.
Если выкладка оборвалась
Из-за set -e скрипт останавливается на первой ошибке, а сайт остаётся закрытым — посетители видят страницу 503, а не полуобновлённый сайт.
- Прочитайте последние строки на экране — в них текст ошибки.
- Исправьте причину по таблице ниже.
- Запустите скрипт заново:
~/deploy.sh. Шаги, которые уже прошли, повторно ничего не испортят. - Если нужно открыть сайт до исправления —
sudo -u www-data php artisan up.
Если сайт открылся, но работает с ошибкой, смотрите журнал: tail -n 50 storage/logs/laravel.log — Журналы Laravel.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
error: Your local changes to the following files would be overwritten by merge: | на сервере правили файлы | Разбор |
fatal: Not possible to fast-forward, aborting. | на сервере есть свои коммиты | Разбор |
detected dubious ownership in repository | git запускали от другого пользователя | Разбор |
Do not run Composer as root/super user! | composer запущен через sudo | запускайте composer от своего пользователя |
| Composer пишет, что lock-файл не совпадает с composer.json | разработчик не обновил composer.lock | Разбор |
Vite manifest not found at: … | не собраны стили и скрипты | npm install и npm run build |
| сайт работает по старому коду | не собран кеш или не перезапущены воркеры | sudo -u www-data php artisan optimize и sudo -u www-data php artisan reload |
laravel.log could not be opened | artisan запускали от своего пользователя или root | Разбор |
| сайт отвечает 503 после выкладки | скрипт остановился до up | см. выше |
Тексты сообщений Laravel сверены по исходному коду Laravel 13.42.0.
Источники
- Документация Laravel: Deployment — на английском: optimize и reload.
- Документация Laravel: Maintenance Mode — на английском: down --render и up.
- Исходный код команды reload в Laravel 13.42.0 — на английском: queue:restart, schedule:interrupt и ключ --except.
- Документация Composer: install — на английском: ключи --no-dev и --optimize-autoloader.
- Документация Git: git pull — на английском: ключ --ff-only.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Laravel на серверевсе статьи о работе проекта на VPS.
- Режим обслуживаниякак закрыть сайт на время работ.
- Резервные копии сайтакопия базы и файлов перед обновлением.