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

Режим обслуживания Laravel: php artisan down и up

Пока вы обновляете код или базу, посетитель может попасть на полуобновлённый сайт и увидеть ошибку. Команда php artisan down закрывает сайт: на любой адрес Laravel отвечает страницей 503 Service Unavailable. Команда php artisan up открывает его снова. Ниже — как закрыть сайт, самому зайти на него во время работ и что ещё останавливается, пока сайт закрыт.

≈ 7 мин чтения
Содержание 12

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

  1. Перейдите в папку проекта: cd /var/www/example.com.
  2. Закройте сайт и получите секретный адрес для себя: sudo -u www-data php artisan down --with-secret --render="errors::503".
  3. Откройте в браузере адрес из ответа — вы увидите сайт, посетители увидят страницу 503.
  4. Закончите работы и откройте сайт: sudo -u www-data php artisan up.

Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Проект в примерах лежит в /var/www/example.com. Команды down и up запускайте от пользователя сайта www-data — так файлы режима обслуживания в storage/framework достанутся ему.

Как закрыть и открыть сайт

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

Ответ: Application is now in maintenance mode. С этой минуты на любой адрес сайта Laravel отвечает кодом 503 и страницей со словами Service Unavailable.

Открыть сайт:

sudo -u www-data php artisan up
ОтветЧто значит
Application is now in maintenance mode.сайт закрыт
Maintenance mode options updated.сайт уже был закрыт, применены новые ключи
Application is now live.сайт открыт
Application is already up.сайт и не был закрыт

Команда down создаёт файл storage/framework/down, команда up удаляет его. Пока файл на месте, сайт закрыт — даже после перезагрузки сервера. Открывает сайт только sudo -u www-data php artisan up.

Как зайти на закрытый сайт самому

sudo -u www-data php artisan down --with-secret

Laravel придумает секрет и покажет адрес в строке You may bypass maintenance mode via [https://example.com/секрет]. Откройте этот адрес в браузере: Laravel поставит в браузер cookie и перенаправит вас на главную. Дальше сайт открывается вам как до закрытия, а посетители без cookie видят страницу 503.

Можно задать секрет самому:

sudo -u www-data php artisan down --secret="moj-sekret-2026"

Тогда адрес для входа — https://example.com/moj-sekret-2026.

  • В секрете — латинские буквы, цифры и дефисы. Знаки ? и & не ставьте: в адресах у них особый смысл.
  • Адрес в ответе Laravel строит из строки APP_URL в .env. Если там http://localhost, замените начало адреса на свой домен и поправьте APP_URL.
  • Cookie хранится в одном браузере. Чтобы зайти с телефона, откройте секретный адрес и на нём.

Ключи php artisan down

КлючЧто делает
--with-secretпридумать секрет для входа и показать адрес
--secret="…"задать свой секрет
--render="errors::503"заранее собрать страницу 503 и отдавать её до загрузки остального кода
--refresh=15браузер посетителя сам обновит страницу через 15 секунд
--retry=60добавить заголовок Retry-After: 60; по словам документации Laravel, браузеры его не учитывают
--redirect=/перенаправлять все адреса на одну страницу
--status=503код ответа; по умолчанию 503

Ключи можно сочетать:

sudo -u www-data php artisan down --with-secret --render="errors::503" --refresh=15

Если сайт уже закрыт, повторный sudo -u www-data php artisan down с другими ключами заменит настройки — ответ Maintenance mode options updated.

Страница 503 во время composer install

Пока идёт composer install, файлы в папке vendor меняются, и Laravel может не загрузиться — посетитель увидит ошибку вместо страницы 503. Ключ --render это исправляет: Laravel заранее собирает страницу, а файл public/index.php отдаёт её в самом начале запроса, до загрузки папки vendor.

sudo -u www-data php artisan down --render="errors::503"

errors::503 — стандартная страница Laravel. Ставьте этот ключ при каждой выкладке — весь порядок команд в статье Выкладка обновлений.

Своя страница вместо стандартной

Создайте в проекте файл resources/views/errors/503.blade.php — Laravel покажет его вместо своей страницы, в том числе с ключом --render="errors::503". Пример простой страницы:

<!DOCTYPE html>
<html lang="ru">
<head>
<meta charset="utf-8">
<title>Сайт обновляется</title>
</head>
<body>
<h1>Сайт обновляется</h1>
<p>Загляните через несколько минут.</p>
</body>
</html>

Файл кладут в репозиторий проекта вместе с остальным кодом. Если шаблоны собраны в кеш, после добавления файла выполните sudo -u www-data php artisan view:cache — подробнее.

Очереди и планировщик

ЧтоПока сайт закрыт
воркеры очередизадачи не берут; задачи ждут в очереди и выполнятся после up
воркер с ключом --forceработает как прежде
задачи по расписаниюне запускаются
задача с ->evenInMaintenanceMode()запускается по расписанию

Если очередь отправляет письма о заказах, на время работ они задержатся. Чтобы воркер работал и при закрытом сайте, допишите --force в строку command= файла Supervisor — Очереди и Supervisor. Про задачи по расписанию — Планировщик Laravel.

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

Файл storage/framework/down лежит на диске одного сервера, поэтому sudo -u www-data php artisan down пришлось бы запускать на каждом. Чтобы закрывать все серверы одной командой, храните отметку в общем кеше — строки в .env:

APP_MAINTENANCE_DRIVER=cache
APP_MAINTENANCE_STORE=database

Хранилище должно быть общим для всех серверов: одна база данных или один Redis. После правки .env соберите кеш настроек: sudo -u www-data php artisan config:cache.

Как проверить

curl -I https://example.com/

В первой строке ответа при закрытом сайте будет 503, при открытом — 200.

php artisan about --only=environment

В строке Maintenance Mode при закрытом сайте стоит ENABLED, при открытом — OFF. Подробнее — php artisan about.

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

Что видитеПричинаЧто делать
сайт отвечает 503 после выкладкине выполнили upsudo -u www-data php artisan up
503 без страницы Laravel, а php artisan about пишет OFFответ дал nginx или PHP-FPMРазбор
секретный адрес тоже отвечает 503в адресе другой секрет или сайт закрыт без секретазакройте сайт заново: sudo -u www-data php artisan down --with-secret
в адресе из ответа localhostв APP_URL адрес из образцазамените домен в адресе и поправьте APP_URL
письма не ушли во время работворкеры не берут задачи при закрытом сайтеоткройте сайт или добавьте воркеру --force
задача по расписанию не выполниласьпланировщик не запускает задачи при закрытом сайтедобавьте задаче ->evenInMaintenanceMode()
ошибка вместо страницы 503 во время composer installсайт закрыт без --rendersudo -u www-data php artisan down --render="errors::503"
Failed to enter maintenance mode: …нет прав на запись в storage/frameworkверните права
Failed to disable maintenance mode: …нет прав на storage/frameworkверните права

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

Источники

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

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

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