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

Laravel на сервере: установка, настройка и обслуживание

Чтобы сайт на Laravel заработал на VPS, мало скопировать файлы: нужны nginx и PHP-FPM, файл .env с настройками рабочего сайта, кеш настроек, воркеры очереди и строка в cron. Потом сайт надо обновлять, не теряя данные, и следить за журналом. Здесь собраны все статьи по порядку — от установки до ежедневной работы.

≈ 5 мин чтения
Содержание 9

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

  1. Если проекта на сервере ещё нет — начните со статьи Установка Laravel и идите по порядку.
  2. Если сайт уже работает — проверьте его одной командой: cd /var/www/example.com && php artisan about — что должно быть в ответе.
  3. Если сайт отвечает ошибкой — найдите её текст в журнале: tail -n 50 storage/logs/laravel.log — Журналы Laravel.

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

Новый проект по шагам

ШагСтатьяЧто сделаете
1Установка Laravelпоставите PHP, Composer и базу, загрузите проект и дадите права
2nginx для Laravelнастроите nginx так, чтобы сайт открывался по домену
3.env на серверевпишете настройки рабочего сайта: APP_ENV, APP_DEBUG, базу и почту
4php artisan optimizeсоберёте кеш настроек, маршрутов и шаблонов
5Очереди и Supervisorзапустите воркеры, которые отправляют письма и выполняют задачи
6Планировщик Laravelдобавите одну строку в cron для задач по расписанию
7php artisan aboutпроверите, что всё настроено

Шаги 5 и 6 нужны, если в проекте есть очереди и задачи по расписанию — уточните у разработчика. Если в .env стоит QUEUE_CONNECTION=sync, задачи выполняются сразу и воркеры не нужны.

Работа с сайтом

ЗадачаСтатья
обновить сайт из GitВыкладка обновлений
закрыть сайт на время работРежим обслуживания
обновить таблицы в базеМиграции на рабочем сайте
перенести кеш, сессии и очереди в RedisLaravel и Redis
найти текст ошибкиЖурналы Laravel
проверить настройки проектаphp artisan about
понять сообщение об ошибкеОшибки Laravel

От какого пользователя запускать команды

КомандыОт когоПочему
git, composer, npmот своего пользователя — владельца папки проектафайлы проекта остаются вашими; Composer не советует запуск от root
php artisan, которые что-то записывают: optimize, migrate, down, up, config:cache, queue:restartsudo -u www-data php artisan …новые файлы в storage и bootstrap/cache достанутся пользователю сайта
php artisan, которые только читают: about, schedule:listможно от своего пользователяничего не записывают

Если запустить artisan от своего пользователя или от root, сайт может потерять право писать в журнал и кеш и ответить ошибкой 500 — laravel.log could not be opened. Как раздать права — Установка Laravel.

Где что лежит

ЧтоГде
папка проекта/var/www/example.com
настройки рабочего сайта.env в папке проекта
папка, которую видит nginxpublic в папке проекта
журнал Laravelstorage/logs/laravel.log
кеш настроек и маршрутовbootstrap/cache
отметка о режиме обслуживанияstorage/framework/down
настройки сайта в nginx/etc/nginx/sites-available/example.com
настройки воркеров/etc/supervisor/conf.d/
строка планировщикарасписание cron пользователя www-data: sudo crontab -u www-data -l

Главные команды

КомандаЧто делает
php artisan aboutсводка о проекте
sudo -u www-data php artisan optimizeсобрать кеш после правки .env или кода
sudo -u www-data php artisan down --render="errors::503"закрыть сайт
sudo -u www-data php artisan upоткрыть сайт
sudo -u www-data php artisan migrate --forceвыполнить новые миграции
sudo -u www-data php artisan reloadперезапустить воркеры и планировщик
tail -n 50 storage/logs/laravel.logпоследние строки журнала
curl -I https://example.com/upпроверить, что сайт отвечает

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

Что видитеЧто делать
страница со словами Server Error и кодом 500Разбор 500
No application encryption key has been specified.Разбор
laravel.log could not be openedРазбор
Vite manifest not found at: …Разбор
сайт отвечает 503 после выкладкиsudo -u www-data php artisan up — Режим обслуживания
сайт работает по старому кодуsudo -u www-data php artisan optimize и sudo -u www-data php artisan reload
другие сообщенияОшибки Laravel — разборы по тексту

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

Источники

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

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

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