Конфиг nginx для Laravel: готовый файл и порядок применения
Конфиг направляет все запросы в public/index.php, отдаёт статику напрямую и закрывает доступ к скрытым файлам. Замените домен, путь к проекту и сокет PHP, затем включите сайт и проверьте синтаксис через sudo nginx -t.
Конфиг
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
Как применить и проверить
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 Настройка nginx как reverse proxy: конфиг и проверка Готовый конфиг nginx как reverse proxy: что делает каждый блок, что заменить под свой сервер, как применить через symlink и reload, как проверить и какие ошибки…
- Конфиг · Nginx Конфиг nginx для WordPress: готовый файл и порядок применения Готовый конфиг nginx для WordPress: что заменить под свой сервер, как подключить сайт, проверить синтаксис и перезагрузить nginx без простоя.
- Ошибка · Nginx Ошибка 502 Bad Gateway в nginx: причины и исправление Разбираем ошибку 502 Bad Gateway в nginx: почему PHP-FPM не отвечает, как читать error.log, проверять сокет и права, чинить таймауты и буферы.
- Руководство · Nginx Docker nginx: установка и настройка обратного прокси Пошагово: установка nginx в Docker на Ubuntu 24.04, конфиг обратного прокси, проверка через curl и разбор частых ошибок с логами.
- Ошибка · Nginx Ошибка 403 Forbidden в nginx: причины и исправление Разбираем ошибку 403 Forbidden в nginx: как найти причину по error.log, проверить права через namei и sudo -u www-data, исправить chmod и deny. Команды для Ubuntu…
- Руководство · Nginx Установка nginx на Ubuntu 24.04 и настройка сайта с PHP Пошаговая установка nginx на Ubuntu 24.04: apt, настройка PHP 8.3 через php-fpm, конфиг сайта, логи и проверка через nginx -t и systemctl status.
Настройка nginx на сервере: от установки до рабочего конфига: все материалы темы