Ошибка php-fpm permission denied: причины и исправление
Ошибка permission denied в PHP-FPM означает, что процесс не может открыть файл, сокет или каталог из-за прав доступа. Чаще всего смотрите на владельца сокета в /run/php, права на каталог сайта в /var/www и на пользователя в секции user пула.
01Неверный пользователь или группа в пуле PHP-FPM
В пуле указан пользователь, которого нет в системе, или у него нет прав на файлы сайта. Проверьте секцию user и group в файле пула и сравните с владельцем каталога сайта. Если PHP-FPM запускается от www-data, а файлы принадлежат root, чтение вернёт permission denied. Исправьте владельца каталога сайта и перезагрузите PHP-FPM.
ls -l /var/www/example.com
sudo chown -R www-data:www-data /var/www/example.com
sudo systemctl reload php8.3-fpm
02Каталог /run/php отсутствует или принадлежит другому пользователю
Сокет PHP-FPM создаётся в /run/php, и после перезагрузки каталог может не существовать. Тогда в логах видно permission denied при попытке создать сокет. Проверьте каталог и права на него. Владельцем должен быть www-data, права 755.
ls -ld /run/php
sudo mkdir -p /run/php
sudo chown www-data:www-data /run/php
sudo chmod 755 /run/php
sudo systemctl restart php8.3-fpm
03nginx не имеет доступа к сокету PHP-FPM
nginx работает от пользователя www-data и должен иметь право подключаться к сокету. Если сокет создан с правами 700 или принадлежит другому пользователю, nginx получит permission denied в error.log. Проверьте права на файл сокета и директиву fastcgi_pass в конфиге сайта.
ls -l /run/php/php8.3-fpm.sock
sudo chown www-data:www-data /run/php/php8.3-fpm.sock
sudo chmod 660 /run/php/php8.3-fpm.sock
sudo nginx -t && sudo systemctl reload nginx
04Ошибка в директиве listen пула
Если в пуле указан TCP-адрес вместо сокета, nginx должен подключаться к тому же адресу. Несовпадение пути сокета в пуле и в fastcgi_pass даёт permission denied или no such file. Сверьте директиву listen в пуле и fastcgi_pass в конфиге nginx.
grep -r "^listen" /etc/php/8.3/fpm/pool.d/
grep -r "fastcgi_pass" /etc/nginx/sites-enabled/
05Проверка, что ошибка исчезла
Перезапустите PHP-FPM и nginx, затем проверьте статус сервисов и лог ошибок. Откройте сайт и убедитесь, что PHP-скрипт выполняется. В логах не должно быть строк permission denied.
sudo systemctl restart php8.3-fpm
sudo systemctl status php8.3-fpm --no-pager
sudo tail -n 20 /var/log/nginx/error.log
curl -I http://example.com
Что не помогает
-
Вы ставите
chmod 777на каталог сайта или сокет.Это открывает доступ всем пользователям. Назначайте владельца
www-dataи права755для каталогов,644для файлов,660для сокета. -
Вы меняете владельца сокета вручную, но не проверяете директиву
listenв пуле.Путь сокета в пуле и в
fastcgi_passдолжен совпадать. Проверьте оба файла и перезапустите PHP-FPM. -
Вы перезапускаете только nginx, а PHP-FPM оставляете без изменений.
После правки пула или прав на каталог перезапускайте PHP-FPM:
sudo systemctl restart php8.3-fpm.
Deploykin
Как это делается в Deploykin
В Deploykin у каждого сайта свой пул PHP-FPM, а его pm.max_children и memory_limit меняются в настройках сайта. Лог PHP-FPM читается в панели, мониторинг снимает метрики PHP-FPM и присылает оповещение, если служба упала.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Где смотреть лог ошибок PHP-FPM?
Лог пула обычно лежит в /var/log/php8.3-fpm.log или указан в директиве error_log пула. Также смотрите journalctl -u php8.3-fpm.
Почему после перезагрузки сервера сокет PHP-FPM пропадает?
Каталог /run очищается при загрузке. Создайте /run/php через tmpfiles.d или проверьте, что сервис PHP-FPM создаёт его сам при старте.
Какой пользователь должен быть владельцем файлов сайта?
Обычно www-data:www-data, если PHP-FPM и nginx работают от этого пользователя. Проверьте секцию user в пуле и владельца каталога /var/www/example.com.
Что означает permission denied при подключении к сокету в nginx?
У пользователя nginx нет прав на сокет. Проверьте права ls -l /run/php/php8.3-fpm.sock и владельца, затем выставьте www-data:www-data и 660.
Ещё по теме
- Ошибка · PHP Ошибка PHP Fatal error: Allowed memory size exhausted Как найти и устранить ошибку нехватки памяти в PHP: проверка memory_limit, настройка php.ini и PHP-FPM, команды для диагностики и исправления.
- Ошибка · PHP Ошибка 502 Bad Gateway в связке nginx и php-fpm Почему nginx отдаёт 502 при работе с php-fpm: разбор причин, команды проверки сокета, пула и логов, исправление конфига и перезапуск php8.3-fpm.
- Ошибка · PHP Ошибка php session permission denied: причины и исправление Ошибка php session permission denied: как найти причину по правам на /var/lib/php/sessions, исправить владельца и права, настроить session.save_path и проверить…
- Руководство · PHP Где находится php.ini и как настроить PHP-FPM на Ubuntu 24.04 Пошаговая настройка php.ini для PHP 8.3 и PHP-FPM на Ubuntu 24.04: где лежит файл, команды проверки, правка лимитов и перезагрузка службы.
- Руководство · PHP PHP 8.3 на Ubuntu 24.04: установка и настройка PHP-FPM Пошаговая установка и настройка PHP 8.3 с PHP-FPM на Ubuntu 24.04: команды, правка пула www, проверка версии и работы сайта.
- Руководство · PHP Настройка nginx и PHP-FPM на Ubuntu 24.04 Настройте nginx и PHP-FPM на Ubuntu 24.04: проверка PHP 8.3, конфиг сайта с fastcgi_pass, пул www, перезагрузка и проверка через curl.
PHP-FPM на сервере: настройка, пул и типичные ошибки: все материалы темы