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

Конфиг nginx для Laravel: готовый файл и порядок применения

Конфиг направляет все запросы в public/index.php, отдаёт статику напрямую и закрывает доступ к скрытым файлам. Замените домен, путь к проекту и сокет PHP, затем включите сайт и проверьте синтаксис через sudo nginx -t.

Конфиг Nginx 3 мин чтения

Конфиг

/etc/nginx/sites-available/example.com
server {
    listen 80;
    listen [::]:80;
    server_name example.com www.example.com;
    root /var/www/example.com/public;

    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-Content-Type-Options "nosniff";

    index index.php;
    charset utf-8;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location = /favicon.ico { access_log off; log_not_found off; }
    location = /robots.txt  { access_log off; log_not_found off; }

    error_page 404 /index.php;

    location ~ ^/index\.php(/|$) {
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
        fastcgi_hide_header X-Powered-By;
    }

    location ~ /\.(?!well-known).* {
        deny all;
    }
}

Что заменить под свой сервер

example.com
ваш домен
/var/www/example.com
папка проекта, root смотрит в её public
php8.3-fpm.sock
сокет установленной версии PHP

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

bash
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

Что делает этот конфиг

Блок server слушает 80 порт по IPv4 и IPv6 и отвечает на запросы к example.com и www.example.com. Директива root указывает на папку public, поэтому nginx не отдаёт файлы из корня Laravel: .env, storage и vendor остаются недоступны. try_files сначала ищет реальный файл или папку, а остальное передаёт в index.php с исходной строкой запроса. error_page 404 /index.php отдаёт обработку ненайденных адресов Laravel, чтобы работали маршруты и страница 404 приложения.

Что заменить под свой сервер

В server_name впишите свой домен и его вариант с www. В root укажите путь к папке проекта, обязательно с /public на конце. В fastcgi_pass подставьте сокет установленной версии PHP: для PHP 8.3 на Ubuntu 24.04 это unix:/run/php/php8.3-fpm.sock. Проверить фактический путь сокета можно командой ls /run/php/.

Как включить сайт и применить конфиг

Сохраните файл как /etc/nginx/sites-available/example.com, затем создайте символическую ссылку в sites-enabled. Перед перезагрузкой проверьте синтаксис через sudo nginx -t: при ошибке nginx покажет файл и строку. Если проверка прошла, перезагрузите nginx без разрыва соединений.

Как проверить, что Laravel отвечает

Откройте http://example.com в браузере: должна загрузиться главная страница приложения. Запрос к несуществующему адресу вроде /no-such-page должен вернуть страницу 404 Laravel, а не стандартную заглушку nginx. Если видите 502, проверьте, запущен ли php8.3-fpm и совпадает ли путь сокета в конфиге.

Права на файлы и кэш

nginx работает от пользователя www-data, и PHP-FPM тоже должен иметь доступ к файлам проекта. Владельцем папки удобно сделать пользователя, под которым вы деплоите код, а группе www-data дать запись только в storage и bootstrap/cache. После изменения .env очистите конфигурационный кэш Laravel командой php artisan config:clear.

Где ошибаются, когда правят конфиг

  • В root указывают корень проекта /var/www/example.com без /public. Nginx начинает отдавать .env и исходники по прямым ссылкам.

    Всегда добавляйте /public: root /var/www/example.com/public;. После правки проверьте sudo nginx -t и перезагрузите nginx.

  • В fastcgi_pass оставляют сокет другой версии PHP, например php8.1-fpm.sock при установленном PHP 8.3. Запросы возвращают 502 Bad Gateway.

    Сверьте имя сокета через ls /run/php/ и укажите существующий файл, для PHP 8.3 это unix:/run/php/php8.3-fpm.sock.

  • Файл лежит в sites-available, но ссылка в sites-enabled не создана. Nginx не видит сайт и отдаёт чужой дефолтный конфиг.

    Создайте ссылку sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/ и перезагрузите nginx.

  • После правки конфига nginx перезапускают без sudo nginx -t. Ошибка в директиве оставляет сервер без рабочего конфига.

    Сначала выполните sudo nginx -t, исправьте строку, которую укажет nginx, и только потом sudo systemctl reload nginx.

Deploykin

Как это делается в Deploykin

В Deploykin сайт создаётся из панели, и конфиг nginx под Laravel, WordPress или PHP панель пишет сама. Править конфиги можно в редакторе панели: перед сохранением конфиг проверяется на сервере, а прежняя версия уходит в резервную копию.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Почему nginx отдаёт 404 вместо страницы Laravel?

Скорее всего, в root указан корень проекта без /public или отсутствует try_files. Проверьте, что root смотрит в /var/www/example.com/public, и перезагрузите nginx после правки.

Какой сокет PHP указывать в fastcgi_pass?

Сокет установленной версии PHP-FPM. Для PHP 8.3 на Ubuntu 24.04 это unix:/run/php/php8.3-fpm.sock. Точный путь покажет ls /run/php/.

Нужно ли добавлять location ~ \.php$?

В этом конфиге достаточно блока location ~ ^/index\.php(/|$): все запросы уже сведены к index.php. Отдельный блок для произвольных .php файлов открыл бы доступ к скриптам вне public.

Как включить HTTPS для этого конфига?

Получите сертификат через sudo certbot --nginx -d example.com -d www.example.com. Certbot добавит блок listen 443 ssl и директивы сертификата в этот же файл, после чего перезагрузит nginx.

Ещё по теме

Настройка nginx на сервере: от установки до рабочего конфига: все материалы темы

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