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

Laravel htaccess: настройка nginx вместо.htaccess

В Laravel файла.htaccess нет: на nginx его роль выполняет конфиг виртуального хоста. Достаточно направить root в каталог public и добавить try_files, чтобы все запросы уходили в index.php. Проверка занимает одну команду curl.

Руководство Laravel 2 мин чтения

01Проверьте, что Laravel установлен

Зайдите на сервер под пользователем, который деплоит проект, и перейдите в каталог сайта. Команда php artisan --version покажет версию Laravel. Если проект ещё не создан, выполните composer create-project laravel/laravel example.com и дальше работайте в каталоге /var/www/example.com.

bash
cd /var/www/example.com
php artisan --version

02Проверьте конфиг nginx для сайта

Откройте файл /etc/nginx/sites-available/example.com. В блоке server директивы root и index должны указывать на каталог public, а location / должен содержать try_files $uri $uri/ /index.php?$query_string. Эти строки заменяют правила из.htaccess: nginx сам отдаёт существующие файлы и передаёт остальное в index.php.

nginx
server {
    listen 80;
    server_name 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;
    }
}

03Закройте доступ к.env и служебным файлам

Каталог .env лежит в корне проекта, на уровень выше public, поэтому при правильном root он недоступен из браузера. Дополнительно закройте точечные файлы и каталог .git отдельным location с deny all. Это защита на случай, если root позже случайно изменят на корень проекта.

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

location ~ /\.git {
    deny all;
}

04Примените конфиг и перезагрузите nginx

Проверьте синтаксис командой sudo nginx -t. Если ошибок нет, перезагрузите nginx: sudo systemctl reload nginx. Симлинк в sites-enabled создаётся один раз командой sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/.

bash
sudo nginx -t
sudo systemctl reload nginx

05Проверьте маршруты и ответ сайта

Команда php artisan route:list покажет зарегистрированные маршруты. Запрос curl -I http://example.com/ должен вернуть 200 OK, а curl -I http://example.com/.env, 403 Forbidden или 404 Not Found. Если на главной ошибка 500, смотрите storage/logs/laravel.log.

bash
php artisan route:list
curl -I http://example.com/
curl -I http://example.com/.env

Частые ошибки

  • В root указан корень проекта /var/www/example.com, и по адресу http://example.com/.env отдаётся файл с паролями.

    Измените root на /var/www/example.com/public, выполните sudo nginx -t и sudo systemctl reload nginx. Проверьте ответ curl -I http://example.com/.env: он должен быть 403 или 404.

  • В location / нет try_files, и внутренние адреса Laravel вроде /login возвращают 404 от nginx.

    Добавьте try_files $uri $uri/ /index.php?$query_string; в location / и перезагрузите nginx.

  • После правки конфига nginx сайт отдаёт 502 Bad Gateway.

    Проверьте, что служба PHP-FPM запущена: sudo systemctl status php8.3-fpm. Путь в fastcgi_pass должен совпадать с listen в пуле /etc/php/8.3/fpm/pool.d/www.conf, по умолчанию это /run/php/php8.3-fpm.sock.

Deploykin

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

В Deploykin сайт на Laravel создаётся из панели: стек под приложение, key:generate и storage:link выполняются при создании, а доступы к базе сами попадают в .env. Деплой идёт без простоя, с миграциями и кэшами, а очереди держат демоны Horizon или Queue Worker.

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

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

Нужен ли файл.htaccess в Laravel на nginx?

Нет. nginx не читает.htaccess, его правила заменяют директивы root на каталог public и try_files в конфиге сайта.

Почему после настройки nginx главная страница отдаёт 403 Forbidden?

Чаще всего root указывает на каталог без index.php или у пользователя www-data нет права читать файлы проекта. Проверьте путь в root и права командой namei -l /var/www/example.com/public/index.php.

Как проверить, что.env недоступен из браузера?

Выполните curl -I http://example.com/.env. Ответ должен быть 403 Forbidden или 404 Not Found, но не 200 OK.

Ещё по теме

Laravel: руководство по установке и настройке: все материалы темы

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