Настройка nginx для Laravel на Ubuntu 24.04
Сайт Laravel открывается через nginx, который передаёт PHP-запросы в PHP-FPM 8.3. Настройка сводится к конфигу сайта с корнем в каталоге public, проверке синтаксиса и перезагрузке службы. В конце сайт открывается по домену, а ошибки видны в логах nginx и Laravel.
01Проверьте, что nginx и PHP-FPM установлены
На сервере уже должны работать nginx и PHP-FPM. Проверьте это одной командой: она покажет версию nginx и состояние службы PHP 8.3. Если пакетов нет, установите их: sudo apt install nginx php8.3-fpm.
nginx -v && systemctl is-active php8.3-fpm
02Установите расширения PHP для Laravel
Laravel 11 и 12 требуют mbstring, xml, curl, zip, bcmath, intl и драйвер базы. Без них composer install падает с ошибкой о недостающем расширении. Установите пакеты и перезагрузите PHP-FPM.
sudo apt install php8.3-mbstring php8.3-xml php8.3-curl php8.3-zip php8.3-bcmath php8.3-intl php8.3-mysql
sudo systemctl reload php8.3-fpm
03Создайте конфиг сайта в sites-available
Файл сайта кладут в /etc/nginx/sites-available/example.com.conf. Корень указывает на каталог public, поэтому .env и код вне него наружу не отдаются. Запросы к несуществующим файлам уходят в index.php через try_files.
server {
listen 80;
server_name example.com www.example.com;
root /var/www/example.com/public;
index index.php;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}
access_log /var/log/nginx/example.com.access.log;
error_log /var/log/nginx/example.com.error.log;
}
04Включите сайт симлинком
nginx читает только файлы из /etc/nginx/sites-enabled/. Симлинк включает конфиг без копирования. Стандартный сайт default отключите, иначе он перехватит запросы по IP.
sudo ln -s /etc/nginx/sites-available/example.com.conf /etc/nginx/sites-enabled/example.com.conf
sudo rm -f /etc/nginx/sites-enabled/default
05Проверьте конфиг и перезагрузите nginx
sudo nginx -t проверяет все файлы конфига и покажет строку с ошибкой. Перезагрузка применяет конфиг без обрыва соединений. Если проверка не прошла, nginx продолжит работать со старым конфигом.
sudo nginx -t
sudo systemctl reload nginx
06Выдайте права на storage и bootstrap/cache
Владелец файлов проекта: пользователь, который деплоит. www-data пишет только в storage и bootstrap/cache, остальное читает. Права задают группой, без chown -R www-data на весь сайт.
cd /var/www/example.com
sudo chown -R $USER:www-data storage bootstrap/cache
sudo chmod -R ug+rwX storage bootstrap/cache
07Проверьте работу сайта и логи
Откройте http://example.com в браузере: должна открыться главная страница Laravel. Ошибки nginx смотрите в /var/log/nginx/example.com.error.log, ошибки приложения в storage/logs/laravel.log. Ответ 500 при APP_DEBUG=false в браузере не показывает причину, её видно только в логе.
curl -I http://example.com
tail -n 50 /var/log/nginx/example.com.error.log
tail -n 50 storage/logs/laravel.log
Частые ошибки
-
В конфиге указан
root /var/www/example.com, а неpublic. Посетители получают доступ к.envи коду приложения.Исправьте
rootна/var/www/example.com/publicи перезагрузите nginx:sudo systemctl reload nginx. -
sudo chown -R www-data:www-data storage bootstrap/cacheвыполнен, после этогоcomposer installиphp artisan optimizeпадают у владельца проекта сPermission denied.Верните владельца и группу:
sudo chown -R $USER:www-data storage bootstrap/cacheиsudo chmod -R ug+rwX storage bootstrap/cache. Команды запускайте без sudo. -
В логе nginx
Primary script unknown, в браузереFile not found.PHP-FPM не нашёл файл поSCRIPT_FILENAME.Проверьте
rootв конфиге сайта и права по всему пути:namei -l /var/www/example.com/public/index.php. Уwww-dataдолжно быть право чтения файла и входа в каждый каталог. -
После правки
.envсайт работает со старыми настройками,env()внеconfig/возвращаетnull.Конфиг закэширован. Выполните
php artisan optimizeилиphp artisan config:clearот владельца проекта.
Deploykin
Как это делается в Deploykin
В Deploykin сайт обновляется после пуша в GitHub: панель запускает deploy-скрипт с миграциями и кэшами, на тарифе Про без простоя. Каждый релиз остаётся в истории, откат делается в один клик.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Нужно ли добавлять fastcgi_param HTTP_COOKIE в конфиг nginx?
Нет. nginx передаёт заголовки запроса, включая Cookie и X-CSRF-TOKEN, в PHP-FPM сам, fastcgi_pass_request_headers включён по умолчанию. Ошибка 419 Page Expired возникает из-за сессии или CSRF-токена в Laravel, а не из-за nginx.
Почему сайт отдаёт 502 Bad Gateway?
Чаще всего PHP-FPM не запущен или сокет /run/php/php8.3-fpm.sock не совпадает с fastcgi_pass. Проверьте systemctl status php8.3-fpm и путь к сокету в конфиге сайта.
Как поднять лимит загрузки файлов?
Лимит задают в двух местах: client_max_body_size в nginx (по умолчанию 1m) и upload_max_filesize с post_max_size в /etc/php/8.3/fpm/php.ini. После правки перезагрузите nginx и PHP-FPM.
Где смотреть ошибки Laravel, если в браузере только 500?
В storage/logs/laravel.log. При APP_DEBUG=false браузер показывает общую страницу, а подробности пишутся в лог. Включать APP_DEBUG=true на рабочем сайте нельзя: посетители увидят пароли из .env.
Ещё по теме
- Руководство · Деплой Как развернуть сайт на VPS: Laravel и PHP на Ubuntu 24.04 Пошаговый деплой сайта на VPS: nginx, PHP 8.3, MySQL 8, git clone, composer install, миграции, права на storage и проверка через curl.
- Руководство · Деплой git pull rebase при деплое Laravel на VPS Как включить git pull rebase для деплоя Laravel на VPS: настройка git config, порядок команд, права на storage, проверка через git log и artisan.
- Руководство · Деплой CI CD на Jenkins: деплой Laravel и PHP-сайтов на VPS Пошаговая настройка CI CD на Jenkins для деплоя Laravel и PHP-сайтов на Ubuntu 24.04: команды сборки, права, миграции и проверка результата.
- Руководство · Деплой git pull submodules при деплое Laravel на VPS Как настроить git pull submodules при деплое Laravel на Ubuntu 24.04: клонирование с подмодулями, обновление, права, composer install и проверка результата.
- Руководство · Деплой Как отменить git pull на сервере: пошаговый разбор Как отменить git pull на Ubuntu 24.04: сохранить правки, вернуть коммиты через git reset и git revert, восстановить деплой Laravel и проверить результат.
- Руководство · Деплой git fetch и git pull: различия и деплой Laravel на VPS Чем git fetch отличается от git pull, как настроить деплой Laravel на Ubuntu 24.04: команды, права на storage, nginx и проверка работы сайта.
Деплой Laravel на сервер: команды, конфиг и ошибки: все материалы темы