phpMyAdmin что это: настройка PHP-FPM на Ubuntu 24.04
phpMyAdmin это веб-интерфейс для управления MySQL, который работает на PHP. Чтобы он открывался на сервере, нужны PHP 8.3 и PHP-FPM, связанные с nginx.
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.
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 не заработает.
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 мог подключиться к сокету.
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 и получите число процессов.
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 в пуле.
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.
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.
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/.
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 База данных MySQL на сервере Ubuntu 24.04: пошаговая настройка Пошагово: проверка MySQL 8.0 на Ubuntu 24.04, создание базы и пользователя, подключение, проверка версии и прав. Команды и проверка результата.
- Руководство · MySQL Настройка phpMyAdmin по http на Ubuntu 24.04 Как открыть phpMyAdmin по http на Ubuntu 24.04: установка без Apache, настройка nginx и PHP-FPM, отдельный пользователь MySQL, проверка входа и типичные ошибки.
- Руководство · MySQL MySQL port: настройка внешнего доступа на Ubuntu 24.04 Пошаговая настройка порта MySQL 3306 на Ubuntu 24.04: bind-address, файрвол, пользователь для внешнего хоста, проверка подключения с другого сервера.
- Руководство · MySQL MySQL консоль на Ubuntu 24.04: вход, команды и проверка Как войти в консоль MySQL на Ubuntu 24.04: sudo mysql, создание пользователя, подключение к базе, проверка и типичные ошибки 1045 и 1698.
- Руководство · MySQL MariaDB в Docker: запуск и настройка на Ubuntu 24.04 Запуск MariaDB в Docker Compose на Ubuntu 24.04: volume, пользователь и база, подключение, удаление базы, дамп и проверка работы контейнера.
- Руководство · MySQL Как посмотреть пользователей MySQL и управлять ими Как посмотреть пользователей MySQL, добавить и удалить их, сменить пароль. Команды для Ubuntu 24.04, проверка списка через mysql.user и SHOW GRANTS.
MySQL на своём сервере: установка, настройка и типичные ошибки: все материалы темы