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

phpMyAdmin что это: настройка PHP-FPM на Ubuntu 24.04

phpMyAdmin это веб-интерфейс для управления MySQL, который работает на PHP. Чтобы он открывался на сервере, нужны PHP 8.3 и PHP-FPM, связанные с nginx.

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

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

Ubuntu 24.04 поставляет PHP 8.3. Пакет php8.3-fpm содержит менеджер процессов FastCGI, php8.3-cli нужен для запуска скриптов из консоли. Расширения ставятся пакетами php8.3-*, например php8.3-mysql для работы с MySQL.

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

02Проверьте версию и модули PHP

Команда php -v покажет версию интерпретатора. Список подключённых расширений выводит php -m. Убедитесь, что среди них есть mysqli и mbstring, иначе phpMyAdmin не заработает.

bash
php -v
php -m

03Настройте пул www

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

ini
sudo nano /etc/php/8.3/fpm/pool.d/www.conf

04Подберите pm.max_children по памяти

По умолчанию в пуле pm = dynamic и pm.max_children = 5. Когда все процессы заняты, новые запросы ждут в очереди сокета, а nginx отдаёт 504 после fastcgi_read_timeout. Размер процесса показывает ps -C php-fpm8.3 -o rss,cmd, RSS в килобайтах. Разделите память, которую можно отдать PHP, на средний RSS и получите число процессов.

bash
ps -C php-fpm8.3 -o rss,cmd

05Поднимите memory_limit для FPM

В FPM по умолчанию memory_limit = 128M, в CLI Ubuntu ставит memory_limit = -1. Скрипт из консоли может пройти, а тот же код на сайте упадёт с ошибкой Allowed memory size of 134217728 bytes exhausted. Лимит меняют в /etc/php/8.3/fpm/php.ini или строкой php_admin_value[memory_limit] = 256M в пуле.

ini
sudo nano /etc/php/8.3/fpm/php.ini

06Проверьте конфиг FPM и перезагрузите службу

Команда sudo php-fpm8.3 -t проверяет конфиг FPM и всех пулов. Если ошибок нет, примените изменения без остановки службы: sudo systemctl reload php8.3-fpm. Лог FPM пишется в /var/log/php8.3-fpm.log.

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

07Свяжите nginx с PHP-FPM

В конфиге сайта nginx передаёт PHP-запросы в сокет через fastcgi_pass unix:/run/php/php8.3-fpm.sock. Параметр SCRIPT_FILENAME должен указывать на реальный файл в root. Если FPM не найдёт файл, в логе nginx появится Primary script unknown, а браузер покажет File not found.

nginx
server {
    listen 80;
    server_name example.com;
    root /var/www/example.com/public;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    }
}

08Проверьте работу сайта

Откройте http://example.com в браузере. Страница phpMyAdmin должна загрузиться без ошибок 502 и 504. Если ответа нет, проверьте статус службы sudo systemctl status php8.3-fpm и наличие сокета командой ls /run/php/.

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

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

  • В логе nginx connect() to unix:/run/php/php8.3-fpm.sock failed (13: Permission denied), браузер отдаёт 502.

    В пуле изменены listen.owner, listen.group или listen.mode. Верните www-data и 0660 в /etc/php/8.3/fpm/pool.d/www.conf и перезагрузите FPM.

  • В логе nginx connect() to unix:/run/php/php8.3-fpm.sock failed (2: No such file or directory), ответ 502.

    PHP-FPM не запущен или в fastcgi_pass указана другая версия PHP. Проверьте ls /run/php/ и sudo systemctl status php8.3-fpm.

  • В логе FPM WARNING: [pool www] server reached pm.max_children setting (5), consider raising it, сайт отвечает медленно и отдаёт 504.

    Все процессы пула заняты. Поднимите pm.max_children по памяти или найдите медленные запросы.

  • Ошибка session_start(): open(/var/lib/php/sessions/sess_…, O_RDWR) failed: Permission denied (13).

    Файл сессии создал другой пользователь, например после смены пользователя пула. Очистите старые сессии в /var/lib/php/sessions или проверьте права на каталог из session.save_path.

Deploykin

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

В Deploykin базы MySQL и пользователи создаются из панели, phpMyAdmin открывается в один клик. Бэкапы баз уходят по расписанию на ваше SFTP-хранилище, сжатыми и проверенными, а восстановление запускается из панели.

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

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

Чем phpMyAdmin отличается от MySQL?

phpMyAdmin это веб-приложение на PHP, которое подключается к MySQL и показывает базы, таблицы и запросы в браузере. Сам MySQL это сервер баз данных, он хранит данные и выполняет запросы.

Зачем для phpMyAdmin нужен PHP-FPM?

PHP-FPM запускает PHP-скрипты и держит пул процессов. nginx передаёт ему запросы к файлам .php через сокет, поэтому без работающего FPM phpMyAdmin не откроется.

Почему сайт отдаёт 502, а не 504?

502 значит, что nginx не смог подключиться к FPM: служба не запущена, сокета нет или нет прав на сокет. 504 появляется, когда все процессы пула заняты и запрос ждёт дольше fastcgi_read_timeout.

Где смотреть лог PHP-FPM?

Лог пишется в /var/log/php8.3-fpm.log. Посмотреть последние строки можно командой sudo tail -n 50 /var/log/php8.3-fpm.log.

Ещё по теме

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

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