PHP-FPM: cannot get uid for user — в пуле указан пользователь, которого нет
В каждом пуле PHP-FPM указано, от какого пользователя работают его процессы и кому принадлежит сокет. Если такого пользователя или группы на сервере нет, PHP-FPM пишет cannot get uid for user или cannot get gid for group и не запускается. Создайте пользователя или поправьте имя в файле пула.
Содержание 14
- Что сделать прямо сейчас
- Как выглядит ошибка
- Какие строки в пуле задают пользователя
- Как проверить пользователя и группу
- Если имя взято из чужой инструкции
- Как создать пользователя для пула
- Если пишет please specify user and group other than root
- Если пишет 'user' directive is ignored
- Если пишет failed to chown() the socket
- Если пишет ACL set, listen.owner is ignored
- Если пишет failed to setuid или failed to setgid
- Ошибки и как их исправить
- Источники
- Что почитать дальше
Что сделать прямо сейчас
- Посмотрите имя в кавычках в сообщении и в квадратных скобках — имя пула.
- Проверьте, есть ли такой пользователь:
id site1— вместоsite1имя из сообщения. Группу проверитgetent group site1. - Если пользователя нет — создайте его или поправьте имя в файле пула. Затем
sudo php-fpm8.3 -tиsudo systemctl restart php8.3-fpm.
Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Команды — для PHP 8.3 из Ubuntu 24.04. В Ubuntu 26.04 стоит PHP 8.5: в путях и командах вместо 8.3 пишите 8.5. Какая версия у вас, покажет ls /etc/php/.
Как выглядит ошибка
[13-Nov-2026 10:00:00] ERROR: [pool site1] cannot get uid for user 'site1'
[13-Nov-2026 10:00:00] ERROR: FPM initialization failed«Пул site1: не удалось получить номер пользователя site1». У каждого пользователя в Linux есть номер — uid. Если номера нет, значит, нет и пользователя. Для группы сообщение cannot get gid for group '…' — «не удалось получить номер группы».
Если ошибка про listen.owner или listen.group, в конце строки — двоеточие, пояснение системы и число в скобках:
ERROR: [pool site1] cannot get uid for user 'nginx': … (…)Эти строки видны в sudo systemctl status php8.3-fpm, sudo journalctl -u php8.3-fpm -n 30 и sudo php-fpm8.3 -t — проверка находит эту ошибку до перезапуска.
Какие строки в пуле задают пользователя
Файл пула — в /etc/php/8.3/fpm/pool.d/, например www.conf:
| Строка | Что задаёт |
|---|---|
user = www-data | от какого пользователя работают процессы PHP этого пула |
group = www-data | их группа; если строки нет — основная группа пользователя из user |
listen.owner = www-data | владелец файла сокета |
listen.group = www-data | группа файла сокета |
В Ubuntu и PHP-FPM, и nginx работают от пользователя www-data. Имя в сообщении ищите в этих строках:
grep -n '^user\|^group\|^listen.owner\|^listen.group' /etc/php/8.3/fpm/pool.d/*.confКак проверить пользователя и группу
id site1Если пользователь есть, в ответе его номер uid=, группа gid= и список групп groups=. Если нет — ответ, что такого пользователя нет.
getent group site1Если группа есть, ответ — строка с её именем и номером. Если нет — пустой ответ.
Если имя взято из чужой инструкции
В инструкциях для других систем пишут listen.owner = nginx или user = apache. В Ubuntu таких пользователей нет: nginx работает от www-data. Замените имя на www-data:
listen.owner = www-data
listen.group = www-dataКак создать пользователя для пула
Если пул нужен для одного сайта и его процессы должны работать от своего пользователя, создайте системного пользователя и группу с тем же именем:
sudo adduser --system --group --no-create-home site1Вместо site1 — имя из файла пула. Такой пользователь не может войти на сервер: он нужен только для процессов PHP. Как завести пользователя, который входит на сервер, — как добавить пользователя.
Файлы сайта должны быть доступны этому пользователю — права на файлы сайта. А сокет должен быть доступен nginx: оставьте в пуле listen.owner = www-data и listen.group = www-data. Как настроить пул для одного сайта — отдельный пул PHP-FPM.
Если пишет please specify user and group other than root
ERROR: [pool www] please specify user and group other than root«Укажите пользователя и группу, отличные от root». В пуле user = root. Процессы PHP выполняют код сайта: если они работают от root, ошибка в коде или взлом сайта дают доступ ко всему серверу. Поэтому PHP-FPM отказывается так запускаться. Верните user = www-data и group = www-data или возьмите пользователя сайта.
Если в пуле нет строки user, а PHP-FPM запущен от root, сообщение другое:
ALERT: [pool www] user has not been defined«Не задан пользователь». Допишите в пул user = www-data и group = www-data.
Если пишет 'user' directive is ignored
NOTICE: [pool www] 'user' directive is ignored when FPM is not running as root«Строка user не действует, потому что PHP-FPM запущен не от root». Это не ошибка. Сменить пользователя процессов может только PHP-FPM, запущенный от root. Служба php8.3-fpm запускается от root — там эта строка действует. Такая запись бывает, если запустить php-fpm8.3 вручную без sudo. Так же PHP-FPM пишет и про 'group', 'chroot' и 'process.priority'.
Если пишет failed to chown() the socket
ERROR: [pool www] failed to chown() the socket '/run/php/php8.3-fpm.sock': … (…)«Не удалось сменить владельца сокета». PHP-FPM создал сокет, но не смог отдать его пользователю из listen.owner и группе из listen.group. Так бывает, если PHP-FPM запущен не от root. Запускайте его службой: sudo systemctl restart php8.3-fpm.
Права на сокет задаёт listen.mode, по умолчанию 0660: читать и писать могут владелец и группа. Если nginx не может подключиться к сокету, сайт отвечает 502 — нет прав на сокет.
Если пишет ACL set, listen.owner is ignored
WARNING: [pool www] ACL set, listen.owner = 'www-data' is ignored«Задан список доступа ACL, поэтому listen.owner не действует». В пуле есть строки listen.acl_users или listen.acl_groups — они дают доступ к сокету по списку пользователей и групп. Тогда listen.owner и listen.group не нужны. Оставьте что-то одно: для одного nginx хватит listen.owner и listen.group.
Если пишет failed to setuid или failed to setgid
ERROR: [pool site1] failed to setuid(…): … (…)«Не удалось переключиться на пользователя пула». Процесс PHP не смог сменить пользователя, на месте многоточия в скобках — номер пользователя. Проверьте, что PHP-FPM запущен службой от root, а пользователь из пула есть на сервере — id site1. Похожие строки — failed to setgid(…) для группы и failed to initgroups(…) для списка групп.
Эти записи пишет сам процесс PHP, поэтому в журнале PHP-FPM они видны, только если в пуле включено catch_workers_output = yes — тогда они внутри записи child … said into stderr (как включить). Без этой настройки в журнале видно только, что процессы завершаются сразу после запуска: exited with code 70, и следом запускаются новые.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
cannot get uid for user '…' | нет такого пользователя | проверьте имя или создайте пользователя |
cannot get gid for group '…' | нет такой группы | проверьте группу |
cannot get uid for user 'nginx' | имя из инструкции для другой системы | замените на www-data |
please specify user and group other than root | пул настроен на root | верните www-data |
user has not been defined | в пуле нет строки user | допишите user и group |
'user' directive is ignored when FPM is not running as root | PHP-FPM запущен не от root | запускайте службой |
failed to chown() the socket | не удалось сменить владельца сокета | запускайте службой |
ACL set, listen.owner = '…' is ignored | заданы и ACL, и listen.owner | оставьте что-то одно |
failed to setuid, failed to setgid | не удалось сменить пользователя | проверьте пользователя |
Тексты сообщений сверены по исходному коду PHP 8.3.6 — эта версия стоит в Ubuntu 24.04.
Источники
- Исходный код PHP-FPM в PHP 8.3.6 — на английском: проверка пользователей и групп, права на сокет в fpm_unix.c.
- Образец настроек пула www.conf — на английском: user, group, listen.owner, listen.group, listen.mode и ACL.
- Справка adduser для Ubuntu 24.04 — на английском: ключи --system, --group и --no-create-home.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Настройки PHP для одного сайтаотдельный пул со своим пользователем.
- Как добавить пользователя в группуесли нужен доступ к файлам сайта.
- Ошибки PHP-FPMвсе ошибки PHP-FPM на одной странице.