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

Выкладка обновлений Laravel на сервер: порядок команд

Новый код мало забрать из Git: Laravel нужно поставить новые пакеты, обновить таблицы в базе, собрать кеш и перезапустить воркеры очереди, которые держат старый код в памяти. Если пропустить шаг, сайт работает по старому коду или отвечает ошибкой. Ниже — порядок команд, что делает каждая, и скрипт, который выполняет их по очереди.

≈ 7 мин чтения8 шагов
Содержание 15

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

  1. Сделайте резервную копию базы — как.
  2. Создайте файл скрипта: nano ~/deploy.sh — и вставьте готовый скрипт.
  3. Разрешите его запуск: chmod +x ~/deploy.sh.
  4. Запустите: ~/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
ШагКомандаЧто делает
1php artisan down --render="errors::503"закрывает сайт: посетители видят страницу 503
2git pull --ff-onlyзабирает новый код из репозитория
3composer install --no-dev --optimize-autoloaderставит пакеты PHP из файла composer.lock
4php artisan migrate --forceобновляет таблицы в базе
5npm install и npm run buildсобирает стили и скрипты в public/build
6php artisan optimizeсобирает кеш настроек, маршрутов и шаблонов
7php artisan reloadперезапускает воркеры очереди и планировщик
8php 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.

СтрокаКоманда внутриЧто делает
queuequeue:restartворкеры доделают текущую задачу и перезапустятся с новым кодом
scheduleschedule: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, а не полуобновлённый сайт.

  1. Прочитайте последние строки на экране — в них текст ошибки.
  2. Исправьте причину по таблице ниже.
  3. Запустите скрипт заново: ~/deploy.sh. Шаги, которые уже прошли, повторно ничего не испортят.
  4. Если нужно открыть сайт до исправления — 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 repositorygit запускали от другого пользователяРазбор
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 openedartisan запускали от своего пользователя или rootРазбор
сайт отвечает 503 после выкладкискрипт остановился до upсм. выше

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

Источники

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

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

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