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

Настройка nginx и PHP-FPM на Ubuntu 24.04

Связка nginx и PHP-FPM отдаёт PHP-скрипты через сокет /run/php/php8.3-fpm.sock. Настройка занимает несколько минут: проверить PHP, создать конфиг сайта, перезагрузить службы и убедиться, что страница отдаёт вывод phpinfo().

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

01Проверьте, что PHP-FPM установлен

На сервере уже должен быть PHP 8.3 с FPM. Одна команда показывает версию CLI, вторая проверяет, что служба php8.3-fpm активна. Если пакета нет, установите его командой sudo apt install php8.3-fpm и переходите к следующему шагу.

bash
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.

nginx
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 не перезагружайте, сначала исправьте файл.

bash
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 подхватывает новый сайт.

bash
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.

bash
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 указывает на существующий сокет.

bash
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, а файлы сайта принадлежат другому пользователю без права чтения для группы. В логе nginx Primary 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-FPM на сервере: настройка, пул и типичные ошибки: все материалы темы

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