К содержимому

Настройка nginx для Laravel на Ubuntu 24.04

Сайт Laravel открывается через nginx, который передаёт PHP-запросы в PHP-FPM 8.3. Настройка сводится к конфигу сайта с корнем в каталоге public, проверке синтаксиса и перезагрузке службы. В конце сайт открывается по домену, а ошибки видны в логах nginx и Laravel.

Руководство Деплой 3 мин чтения

01Проверьте, что nginx и PHP-FPM установлены

На сервере уже должны работать nginx и PHP-FPM. Проверьте это одной командой: она покажет версию nginx и состояние службы PHP 8.3. Если пакетов нет, установите их: sudo apt install nginx php8.3-fpm.

bash
nginx -v && systemctl is-active php8.3-fpm

02Установите расширения PHP для Laravel

Laravel 11 и 12 требуют mbstring, xml, curl, zip, bcmath, intl и драйвер базы. Без них composer install падает с ошибкой о недостающем расширении. Установите пакеты и перезагрузите PHP-FPM.

bash
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.

nginx
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.

bash
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 продолжит работать со старым конфигом.

bash
sudo nginx -t
sudo systemctl reload nginx

06Выдайте права на storage и bootstrap/cache

Владелец файлов проекта: пользователь, который деплоит. www-data пишет только в storage и bootstrap/cache, остальное читает. Права задают группой, без chown -R www-data на весь сайт.

bash
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 в браузере не показывает причину, её видно только в логе.

bash
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.

Ещё по теме

Деплой Laravel на сервер: команды, конфиг и ошибки: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.