nginx и PHP-FPM: блок location для PHP и fastcgi_pass
nginx сам не выполняет PHP: файлы .php он передаёт программе PHP-FPM. Для этого в настройках сайта нужен блок location с директивой fastcgi_pass — она указывает, где PHP-FPM принимает запросы.
Содержание 12
Что сделать прямо сейчас
- Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.
- Посмотрите имя сокета PHP-FPM:
ls /run/php/. В Ubuntu 24.04 это php8.3-fpm.sock, в 26.04 — php8.5-fpm.sock. Если папки нет, PHP-FPM не установлен — Установка PHP на Ubuntu. - Откройте файл сайта:
sudo nano /etc/nginx/sites-available/example.com. Вместо example.com — имя файла вашего сайта: список покажетls /etc/nginx/sites-enabled/. Если система спросит пароль, введите пароль своего пользователя на сервере. Символы при вводе не видны — наберите пароль и нажмите Enter. - Внутри блока server замените строку index и добавьте блок для PHP из раздела ниже. Если сокет называется иначе, исправьте строку fastcgi_pass.
- Сохраните файл — Ctrl+O, Enter, затем Ctrl+X — и проверьте настройки:
sudo nginx -t. В ответе должны быть слова syntax is ok и test is successful. Тогда примените их:sudo systemctl reload nginx. Если команда ничего не ответила, настройки применены. - Проверьте пробным файлом — как проверить.
Если проверка нашла ошибку, nginx назовёт файл и номер строки, а сайт продолжит работать на старых настройках. Что значит сообщение — Все ошибки nginx.
Блок для PHP
index index.php index.html;
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}| Строка | Что значит |
|---|---|
index index.php index.html | какой файл открыть, если адрес заканчивается на «/»: сначала index.php, потом index.html |
location ~ \.php$ | блок для адресов, которые заканчиваются на .php. Знак ~ значит, что дальше регулярное выражение: \. — точка, $ — конец адреса |
include snippets/fastcgi-php.conf | подключить готовые строки из пакета nginx — что в них |
fastcgi_pass unix:/run/php/php8.3-fpm.sock | куда передать запрос: файл-сокет PHP-FPM |
В файле default из пакета nginx такой блок уже есть, но он закомментирован и указывает на сокет php7.4-fpm.sock. Если берёте его оттуда, уберите знаки # и исправьте имя сокета.
Что внутри fastcgi-php.conf
Файл /etc/nginx/snippets/fastcgi-php.conf ставится вместе с nginx. Без комментариев в нём пять строк и одна вставка:
fastcgi_split_path_info ^(.+?\.php)(/.*)$;
try_files $fastcgi_script_name =404;
set $path_info $fastcgi_path_info;
fastcgi_param PATH_INFO $path_info;
fastcgi_index index.php;
include fastcgi.conf;| Строка | Что делает |
|---|---|
fastcgi_split_path_info | делит адрес вида /index.php/news на имя скрипта /index.php и хвост /news |
try_files $fastcgi_script_name =404 | если такого файла .php нет, nginx сам ответит 404 и не будет обращаться к PHP |
set и fastcgi_param PATH_INFO | передают хвост адреса в PHP как PATH_INFO |
fastcgi_index index.php | какой скрипт подставить, если адрес заканчивается на «/» |
include fastcgi.conf | подключить список параметров, которые nginx передаёт PHP: путь к файлу, адрес, метод, заголовки |
Свои строки для PHP пишите в блок location, а не в этот файл: так все настройки сайта видны в одном месте.
fastcgi.conf или fastcgi_params
В папке /etc/nginx/ два похожих файла. fastcgi.conf — это fastcgi_params и ещё одна строка, в которой nginx передаёт PHP полный путь к файлу:
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;В инструкциях из интернета встречается include fastcgi_params;. Если в таком блоке нет строки SCRIPT_FILENAME, PHP-FPM не узнает, какой файл выполнять, и браузер покажет «File not found.». Допишите строку выше или замените include на include snippets/fastcgi-php.conf; — разбор в статье File not found. и Primary script unknown.
Сокет или порт
Где PHP-FPM принимает запросы, задаёт строка listen в файле /etc/php/8.3/fpm/pool.d/www.conf. Посмотрите её:
grep '^listen' /etc/php/8.3/fpm/pool.d/www.conf| Строка в www.conf | Строка в nginx |
|---|---|
listen = /run/php/php8.3-fpm.sock | fastcgi_pass unix:/run/php/php8.3-fpm.sock; |
listen = 127.0.0.1:9000 | fastcgi_pass 127.0.0.1:9000; |
Сокет — это файл, через который nginx и PHP-FPM общаются внутри одного сервера. Порт нужен, если PHP-FPM работает на другом сервере или в контейнере. Порт 9000 не открывайте в файрволе: PHP-FPM выполнит файл, путь к которому ему передадут.
После правки www.conf перезапустите PHP-FPM: sudo systemctl restart php8.3-fpm. Отдельный пул и свой сокет для одного сайта — Настройки PHP для одного сайта.
Запретить PHP в папке загрузок
В папку загрузок посетители и плагины кладут файлы. Если туда попадёт файл .php, блок для PHP выполнит его. Запретите это блоком, который стоит в файле выше блока для PHP:
location ~* /wp-content/uploads/.*\.php$ {
deny all;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}Блоки с регулярными выражениями nginx проверяет по порядку и берёт первый подходящий, поэтому запрет ставят первым. Путь /wp-content/uploads/ — для WordPress, у другой CMS подставьте её папку. Проверка: curl -I https://example.com/wp-content/uploads/x.php — в ответе должен быть код 403.
Долгие скрипты
nginx ждёт ответа PHP-FPM 60 секунд — это директива fastcgi_read_timeout. Если скрипт работает дольше, посетитель получит ошибку 504. Как найти медленный скрипт и поднять время ожидания — ошибка 504.
Свои страницы ошибок для PHP
Если PHP сам ответил кодом 404 или 500, nginx передаст его страницу как есть. Чтобы вместо неё показывалась страница из error_page, добавьте в блок для PHP строку fastcgi_intercept_errors on;. Подробнее — error_page в nginx.
Как проверить
Создайте пробный файл. Вместо /var/www/example.com — папка сайта из строки root:
echo '<?php echo "PHP работает";' | sudo tee /var/www/example.com/test.phpОткройте в браузере example.com/test.php: должна быть надпись «PHP работает». Код ответа покажет команда:
curl -I https://example.com/test.phpВ ответе должны быть код 200 и строка Content-Type: text/html. curl может показать имена заголовков маленькими буквами — это то же самое. Если вместо страницы браузер скачивает файл, а curl показывает application/octet-stream, запрос не дошёл до PHP: проверьте блок location и выполните reload. Пробный файл после проверки удалите:
sudo rm /var/www/example.com/test.phpОшибки и как их исправить
Причину покажет журнал ошибок nginx: sudo tail -n 20 /var/log/nginx/error.log.
| Что видите | Что делать |
|---|---|
502, в журнале connect() to unix:/run/php/php8.3-fpm.sock failed (2: No such file or directory) | PHP-FPM не запущен или в fastcgi_pass другая версия — разбор |
502, в журнале (13: Permission denied) при подключении к сокету | нет прав на сокет |
502, в журнале (11: Resource temporarily unavailable) | заняты все процессы PHP-FPM — разбор и pm.max_children |
502, в журнале upstream sent too big header | заголовки ответа не помещаются в буфер |
«File not found.», в журнале Primary script unknown | нет SCRIPT_FILENAME или root задан не там — разбор |
| 404 на файл .php, который есть | nginx ищет файл по строке root: проверьте, где задан root |
| браузер скачивает файл .php | запрос не дошёл до PHP: нет блока, не выполнен reload или адрес забрал блок папки без вложенного блока для PHP — пример с паролем на папку |
504, в журнале upstream timed out (110: Connection timed out) | скрипт работает дольше 60 секунд |
Источники
- Документация nginx: модуль ngx_http_fastcgi_module — fastcgi_pass, fastcgi_param, fastcgi_index, fastcgi_split_path_info, fastcgi_read_timeout и fastcgi_intercept_errors.
- Файл snippets/fastcgi-php.conf из пакета nginx в Ubuntu 24.04 — fastcgi_split_path_info, проверка try_files, PATH_INFO, fastcgi_index и подключение fastcgi.conf.
- Файл fastcgi.conf из пакета nginx в Ubuntu 24.04 — те же строки, что в fastcgi_params, и SCRIPT_FILENAME.
- Файл sites-available/default из пакета nginx в Ubuntu 24.04 — сайт по умолчанию:
listen 80 default_server,server_name _, try_files. - Документация nginx: директива location — блоки с регулярными выражениями проверяются по порядку, срабатывает первый подходящий.
Сверено 23 октября 2026 года.
Что почитать дальше
- Установка PHP на Ubuntuphp-fpm, модули и где настройки PHP.
- Как разместить сайт на VPSсайт на PHP с нуля.
- Ошибка 502 Bad Gatewayвсе причины по строкам журнала.
- File not found. и Primary script unknownPHP не нашёл файл.
- error_page в nginxсвои страницы ошибок.
- Настройки nginxкак устроены файлы и блоки, главные директивы.
- Access to the script has been deniedесли вместо страницы одна строка
Access denied. - Ошибки PHP-FPMчто значит запись в журнале PHP-FPM.
- nginx для Laravelблок location и fastcgi_pass для проекта на Laravel.