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

PHP 8.3 на Ubuntu 24.04: установка и настройка PHP-FPM

Ubuntu 24.04 поставляет PHP 8.3 в штатных репозиториях, отдельно ставить PPA не нужно.

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

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

На сервере, где PHP 8.3 уже стоит, версия видна одной командой. Если вывод содержит PHP 8.3, переходите к проверке службы PHP-FPM. Если команда не найдена или версия другая, установите пакеты на следующем шаге.

bash
php -v

02Установите PHP 8.3 и PHP-FPM

Пакет php8.3-fpm содержит сам PHP-FPM и пул www, пакет php8.3-cli даёт консольный php. Расширения ставятся пакетами php8.3-*, например php8.3-mysql для работы с MySQL 8.0. После установки служба php8.3-fpm уже запущена.

bash
sudo apt update
sudo apt install -y php8.3-fpm php8.3-cli php8.3-mysql

03Проверьте службу PHP-FPM и сокет

Пул www из пакета слушает Unix-сокет /run/php/php8.3-fpm.sock. Служба должна быть в состоянии active (running), а сокет присутствовать в /run/php/. Если сокета нет, смотрите лог /var/log/php8.3-fpm.log.

bash
sudo systemctl status php8.3-fpm
ls /run/php/

04Настройте пул www под нагрузку

Параметры пула лежат в /etc/php/8.3/fpm/pool.d/www.conf. По умолчанию там pm = dynamic и pm.max_children = 5, этого мало для сайта с одновременными запросами. Значение pm.max_children считают по памяти: свободная под PHP память делится на средний размер процесса, который показывает ps -C php-fpm8.3 -o rss,cmd в килобайтах.

ini
pm = dynamic
pm.max_children = 20
pm.start_servers = 5
pm.min_spare_servers = 5
pm.max_spare_servers = 10

05Примените конфиг FPM

Синтаксис конфига FPM и всех пулов проверяет sudo php-fpm8.3 -t. Перезагрузка sudo systemctl reload php8.3-fpm применяет новый конфиг без остановки службы, активные запросы дорабатывают. Полный перезапуск нужен только при смене версии PHP.

bash
sudo php-fpm8.3 -t
sudo systemctl reload php8.3-fpm

06Проверьте, что сайт работает на PHP 8.3

Положите в корень сайта файл index.php с вызовом phpinfo() и запросите страницу через nginx. Команда curl без -I получает тело ответа, в нём будет версия PHP и настройки FPM. Уберите файл сразу после проверки: phpinfo() раскрывает версии и пути всем посетителям.

bash
echo '<?php phpinfo();' | sudo tee /var/www/example.com/public/index.php
curl http://example.com/
sudo rm /var/www/example.com/public/index.php

Частые ошибки

  • Скрипт из консоли проходит, а на сайте падает с PHP Fatal error: Allowed memory size of 134217728 bytes exhausted. В CLI Ubuntu ставит memory_limit = -1, а в FPM по умолчанию 128M.

    Поднимите лимит в /etc/php/8.3/fpm/php.ini или в пуле строкой php_admin_value[memory_limit] = 256M и выполните sudo systemctl reload php8.3-fpm. Проверяйте php --ini только для CLI, у FPM свой файл /etc/php/8.3/fpm/php.ini.

  • Сайт отвечает 502, в логе nginx connect() to unix:/run/php/php8.3-fpm.sock failed (13: Permission denied). В пуле изменены listen.owner, listen.group или listen.mode, и nginx не может открыть сокет.

    Верните в /etc/php/8.3/fpm/pool.d/www.conf значения listen.owner = www-data, listen.group = www-data и listen.mode = 0660, затем перезагрузите FPM. Права на сам файл сокета вручную менять не нужно.

  • В логе nginx Primary script unknown, посетитель видит File not found. PHP-FPM не нашёл файл по SCRIPT_FILENAME.

    Проверьте root в конфиге nginx и права по всему пути к файлу командой namei -l /var/www/example.com/public/index.php. Пользователь пула www-data должен читать файл и входить в каждый каталог пути.

  • В /var/log/php8.3-fpm.log появляется WARNING: [pool www] server reached pm.max_children setting (5), consider raising it, сайт тормозит и отдаёт 504.

    Поднимите pm.max_children по доступной памяти или найдите медленные запросы. Пока все процессы заняты, новые запросы ждут в очереди сокета, и nginx отдаёт 504 после fastcgi_read_timeout.

Deploykin

Как это делается в Deploykin

В Deploykin версия PHP выбирается для каждого сайта отдельно, а авто-тюнинг подбирает настройки PHP-FPM, MySQL и Nginx под ресурсы сервера. Рекомендации применяются в один клик.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Какая версия PHP в Ubuntu 24.04 по умолчанию?

Ubuntu 24.04 поставляет PHP 8.3: пакеты php8.3-fpm, php8.3-cli и расширения php8.3-*. Другие версии, например 8.4, ставят из PPA ppa:ondrej/php, у каждой версии своя служба php8.X-fpm и свой каталог /etc/php/8.X/.

Где лежит php.ini для PHP-FPM?

У FPM и CLI разные файлы: /etc/php/8.3/fpm/php.ini и /etc/php/8.3/cli/php.ini. Команда php --ini показывает файл CLI, поэтому правки в нём не влияют на сайт.

Как проверить конфиг PHP-FPM перед перезагрузкой?

Выполните sudo php-fpm8.3 -t: команда проверяет основной конфиг и все пулы из /etc/php/8.3/fpm/pool.d/. Применяет изменения sudo systemctl reload php8.3-fpm без остановки службы.

Почему nginx отдаёт 502 при работающем PHP-FPM?

Чаще всего nginx не может подключиться к сокету: FPM не запущен, в fastcgi_pass указана другая версия PHP или в пуле сбиты listen.owner, listen.group и listen.mode. Проверьте ls /run/php/ и sudo systemctl status php8.3-fpm.

Ещё по теме

PHP-FPM на сервере: настройка, пул и типичные ошибки: все материалы темы

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