Поиск
Справочник

nginx и PHP-FPM: блок location для PHP и fastcgi_pass

nginx сам не выполняет PHP: файлы .php он передаёт программе PHP-FPM. Для этого в настройках сайта нужен блок location с директивой fastcgi_pass — она указывает, где PHP-FPM принимает запросы.

≈ 9 мин чтения
Содержание 12

Что сделать прямо сейчас

  1. Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.
  2. Посмотрите имя сокета PHP-FPM: ls /run/php/. В Ubuntu 24.04 это php8.3-fpm.sock, в 26.04 — php8.5-fpm.sock. Если папки нет, PHP-FPM не установлен — Установка PHP на Ubuntu.
  3. Откройте файл сайта: sudo nano /etc/nginx/sites-available/example.com. Вместо example.com — имя файла вашего сайта: список покажет ls /etc/nginx/sites-enabled/. Если система спросит пароль, введите пароль своего пользователя на сервере. Символы при вводе не видны — наберите пароль и нажмите Enter.
  4. Внутри блока server замените строку index и добавьте блок для PHP из раздела ниже. Если сокет называется иначе, исправьте строку fastcgi_pass.
  5. Сохраните файл — Ctrl+O, Enter, затем Ctrl+X — и проверьте настройки: sudo nginx -t. В ответе должны быть слова syntax is ok и test is successful. Тогда примените их: sudo systemctl reload nginx. Если команда ничего не ответила, настройки применены.
  6. Проверьте пробным файлом — как проверить.

Если проверка нашла ошибку, 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.sockfastcgi_pass unix:/run/php/php8.3-fpm.sock;
listen = 127.0.0.1:9000fastcgi_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 секунд

Источники

Сверено 23 октября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше