Настройка nginx и PHP-FPM на Ubuntu 24.04
Связка nginx и PHP-FPM отдаёт PHP-скрипты через сокет /run/php/php8.3-fpm.sock. Настройка занимает несколько минут: проверить PHP, создать конфиг сайта, перезагрузить службы и убедиться, что страница отдаёт вывод phpinfo().
01Проверьте, что PHP-FPM установлен
На сервере уже должен быть PHP 8.3 с FPM. Одна команда показывает версию CLI, вторая проверяет, что служба php8.3-fpm активна. Если пакета нет, установите его командой sudo apt install php8.3-fpm и переходите к следующему шагу.
php -v
sudo systemctl status php8.3-fpm
02Создайте конфиг сайта в nginx
Положите файл /etc/nginx/sites-available/example.com с блоком server. Директива root указывает на каталог сайта, а location ~ \.php$ передаёт запросы в FPM через сокет. Сокет должен совпадать с тем, что слушает пул www в /etc/php/8.3/fpm/pool.d/www.conf.
server {
listen 80;
server_name example.com;
root /var/www/example.com;
index index.php index.html;
location / {
try_files $uri $uri/ =404;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}
}
03Включите сайт и проверьте конфигурацию nginx
Симлинк в sites-enabled включает сайт. Перед перезагрузкой проверьте синтаксис: sudo nginx -t должен ответить syntax is ok и test is successful. Если проверка не прошла, nginx не перезагружайте, сначала исправьте файл.
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/
sudo nginx -t
04Перезагрузите nginx и PHP-FPM
Перезагрузка применяет новый конфиг без остановки служб. Сначала перезагрузите PHP-FPM, затем nginx. Команда sudo systemctl reload php8.3-fpm не рвёт соединения, а sudo systemctl reload nginx подхватывает новый сайт.
sudo systemctl reload php8.3-fpm
sudo systemctl reload nginx
05Проверьте работу через curl
Создайте тестовый файл /var/www/example.com/index.php с вызовом phpinfo(). Запрос с самого сервера на 127.0.0.1 с заголовком Host: example.com должен вернуть HTML с версией PHP 8.3. Если в ответе 502 Bad Gateway, смотрите лог nginx и статус службы php8.3-fpm.
echo '<?php phpinfo();' | sudo tee /var/www/example.com/index.php
curl -H 'Host: example.com' http://127.0.0.1/
06Убедитесь, что PHP-код выполняется
В выводе curl ищите строку PHP Version 8.3. Она значит, что nginx передал запрос в FPM, а FPM выполнил скрипт. Если вместо HTML пришёл исходный код <?php phpinfo();, проверьте, что location ~ \.php$ не перекрыт другим блоком и что fastcgi_pass указывает на существующий сокет.
curl -s -H 'Host: example.com' http://127.0.0.1/ | grep 'PHP Version'
Частые ошибки
-
В
fastcgi_passуказан сокет другой версии, например/run/php/php8.2-fpm.sock, а службаphp8.3-fpmслушает/run/php/php8.3-fpm.sock. nginx отвечает 502, в логеconnect() to unix:/run/php/php8.2-fpm.sock failed (2: No such file or directory).Приведите путь в
fastcgi_passк сокету из пулаwwwв/etc/php/8.3/fpm/pool.d/www.conf. Проверьтеls /run/php/и перезагрузите nginx. -
Пул
wwwработает отwww-data, а файлы сайта принадлежат другому пользователю без права чтения для группы. В логе nginxPrimary script unknown, в ответеFile not found.Дайте
www-dataчтение файлов и проход по каталогам: владелец или группа с правом чтения. Права по пути покажетnamei -l /var/www/example.com/index.php. -
После правки
php.iniили пула выполнена толькоsudo systemctl reload nginx. PHP-FPM продолжает работать со старым конфигом.Проверьте конфиг командой
sudo php-fpm8.3 -tи примените его черезsudo systemctl reload php8.3-fpm.
Deploykin
Как это делается в Deploykin
В Deploykin версия PHP выбирается для каждого сайта отдельно, а авто-тюнинг подбирает настройки PHP-FPM, MySQL и Nginx под ресурсы сервера. Рекомендации применяются в один клик.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Какой сокет указывать в fastcgi_pass для PHP 8.3 на Ubuntu 24.04?
Пул www из пакета php8.3-fpm слушает /run/php/php8.3-fpm.sock. Этот путь и указывайте в fastcgi_pass unix:/run/php/php8.3-fpm.sock.
Почему nginx отдаёт 502 Bad Gateway?
Чаще всего PHP-FPM не запущен, сокета нет или у nginx нет прав на подключение к нему. Проверьте sudo systemctl status php8.3-fpm и ls /run/php/, затем посмотрите лог nginx.
Нужно ли перезагружать PHP-FPM после правки конфига сайта в nginx?
Нет, правка сайта в nginx требует только sudo systemctl reload nginx. Перезагрузка php8.3-fpm нужна после изменения php.ini или файлов пула в /etc/php/8.3/fpm/pool.d/.
Где смотреть ошибки PHP-FPM?
В логе /var/log/php8.3-fpm.log. Команда sudo tail -n 50 /var/log/php8.3-fpm.log покажет последние записи, включая предупреждения о нехватке процессов пула.
Ещё по теме
- Руководство · PHP Где находится php.ini и как настроить PHP-FPM на Ubuntu 24.04 Пошаговая настройка php.ini для PHP 8.3 и PHP-FPM на Ubuntu 24.04: где лежит файл, команды проверки, правка лимитов и перезагрузка службы.
- Руководство · PHP PHP 8.3 на Ubuntu 24.04: установка и настройка PHP-FPM Пошаговая установка и настройка PHP 8.3 с PHP-FPM на Ubuntu 24.04: команды, правка пула www, проверка версии и работы сайта.
- Руководство · PHP PHP2Shell: две критические уязвимости в PHP и как их закрыть Две критические уязвимости PHP от 21 октября 2026 года позволяют выполнить код на сервере без авторизации. Какие версии уязвимы, как проверить сервер и обновиться.
- Руководство · PHP Как обновить PHP на Ubuntu до патч-релиза Как обновить PHP 8.2-8.5 на Ubuntu до последнего патч-релиза: проверить версию и репозиторий, обновить пакеты ветки, перезапустить PHP-FPM и включить автообновление.
- Конфиг · PHP Настройка пула PHP-FPM: конфиг www.conf и его параметры Готовый конфиг пула PHP-FPM для Ubuntu 24.04: pm.max_children, start_servers, max_requests. Как проверить php-fpm8.3 -t и применить reload без простоя.
- Ошибка · PHP Ошибка php-fpm permission denied: причины и исправление Разбираем ошибку php-fpm permission denied: почему PHP-FPM не запускается и не читает сокет, как проверить права на /run/php и /var/www, исправить конфиг пула и…
PHP-FPM на сервере: настройка, пул и типичные ошибки: все материалы темы