Laravel на сервере: установка, настройка и обслуживание
Чтобы сайт на Laravel заработал на VPS, мало скопировать файлы: нужны nginx и PHP-FPM, файл .env с настройками рабочего сайта, кеш настроек, воркеры очереди и строка в cron. Потом сайт надо обновлять, не теряя данные, и следить за журналом. Здесь собраны все статьи по порядку — от установки до ежедневной работы.
Содержание 9
Что сделать прямо сейчас
- Если проекта на сервере ещё нет — начните со статьи Установка Laravel и идите по порядку.
- Если сайт уже работает — проверьте его одной командой:
cd /var/www/example.com && php artisan about— что должно быть в ответе. - Если сайт отвечает ошибкой — найдите её текст в журнале:
tail -n 50 storage/logs/laravel.log— Журналы Laravel.
Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Проект в примерах лежит в /var/www/example.com.
Новый проект по шагам
| Шаг | Статья | Что сделаете |
|---|---|---|
| 1 | Установка Laravel | поставите PHP, Composer и базу, загрузите проект и дадите права |
| 2 | nginx для Laravel | настроите nginx так, чтобы сайт открывался по домену |
| 3 | .env на сервере | впишете настройки рабочего сайта: APP_ENV, APP_DEBUG, базу и почту |
| 4 | php artisan optimize | соберёте кеш настроек, маршрутов и шаблонов |
| 5 | Очереди и Supervisor | запустите воркеры, которые отправляют письма и выполняют задачи |
| 6 | Планировщик Laravel | добавите одну строку в cron для задач по расписанию |
| 7 | php artisan about | проверите, что всё настроено |
Шаги 5 и 6 нужны, если в проекте есть очереди и задачи по расписанию — уточните у разработчика. Если в .env стоит QUEUE_CONNECTION=sync, задачи выполняются сразу и воркеры не нужны.
Работа с сайтом
| Задача | Статья |
|---|---|
| обновить сайт из Git | Выкладка обновлений |
| закрыть сайт на время работ | Режим обслуживания |
| обновить таблицы в базе | Миграции на рабочем сайте |
| перенести кеш, сессии и очереди в Redis | Laravel и Redis |
| найти текст ошибки | Журналы Laravel |
| проверить настройки проекта | php artisan about |
| понять сообщение об ошибке | Ошибки Laravel |
От какого пользователя запускать команды
| Команды | От кого | Почему |
|---|---|---|
git, composer, npm | от своего пользователя — владельца папки проекта | файлы проекта остаются вашими; Composer не советует запуск от root |
php artisan, которые что-то записывают: optimize, migrate, down, up, config:cache, queue:restart | sudo -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 в папке проекта |
| папка, которую видит nginx | public в папке проекта |
| журнал Laravel | storage/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.
Источники
- Документация Laravel: Deployment — на английском: настройка сервера, optimize, reload и адрес /up.
- Документация Laravel: Configuration — на английском: .env, команда about и режим обслуживания.
- Документация Laravel: Queues — на английском: воркеры и Supervisor.
- Документация Laravel: Task Scheduling — на английском: строка schedule:run в cron.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Установка Laravelпервый шаг для нового проекта.
- Ошибки Laravelчто значат сообщения и как их исправить.
- Установка PHPPHP и PHP-FPM на Ubuntu 24.04.