Laravel htaccess: настройка nginx вместо.htaccess
В Laravel файла.htaccess нет: на nginx его роль выполняет конфиг виртуального хоста. Достаточно направить root в каталог public и добавить try_files, чтобы все запросы уходили в index.php. Проверка занимает одну команду curl.
01Проверьте, что Laravel установлен
Зайдите на сервер под пользователем, который деплоит проект, и перейдите в каталог сайта. Команда php artisan --version покажет версию Laravel. Если проект ещё не создан, выполните composer create-project laravel/laravel example.com и дальше работайте в каталоге /var/www/example.com.
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.
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 позже случайно изменят на корень проекта.
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/.
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.
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 PHP Laravel: пошаговая настройка проекта на Ubuntu 24.04 Создайте проект Laravel на PHP 8.3 в Ubuntu 24.04: Composer,.env, MySQL, миграции, nginx, кэш и проверка запуска. Команды и типичные ошибки.
- Руководство · Laravel Filament в Laravel: установка и настройка панели Установка Filament 5 в Laravel на Ubuntu 24.04: панель /admin, пользователь, ресурс Customer, доступ на сервере и проверка входа без ошибки 403.
- Руководство · Laravel Laravel Livewire: установка и первый компонент на Ubuntu 24.04 Установка Livewire 4 в Laravel на Ubuntu 24.04: создание компонента, вывод на страницу, настройка nginx для livewire.min.js и проверка работы в браузере.
- Руководство · Laravel Laravel API: пошаговая настройка на Ubuntu 24.04 Как поднять API в Laravel на Ubuntu 24.04: установка Sanctum, маршруты в routes/api.php, проверка через curl, ответы 401 и 404, кэш и деплой.
- Руководство · Laravel Laravel Eloquent: настройка и проверка на Ubuntu 24.04 Пошаговая настройка Eloquent в Laravel на Ubuntu 24.04: подключение MySQL, миграции, модели, связи, проверка через tinker и маршрут.
- Руководство · Laravel Laravel install: установка фреймворка на Ubuntu 24.04 Пошаговая установка Laravel на Ubuntu 24.04: проверка PHP 8.3, composer create-project, ключ приложения,.env, миграции и запуск через php artisan serve.
Laravel: руководство по установке и настройке: все материалы темы