AH01071: Got error 'Primary script unknown' — PHP-FPM не нашёл файл
Apache передал запрос PHP-FPM, а тот не нашёл PHP-файл по указанному пути и ответил «File not found». Ошибка бывает, только если PHP работает через PHP-FPM. Найдите, куда Apache отправляет PHP-файлы, и сверьте путь с папкой сайта.
Содержание 9
Что сделать прямо сейчас
- Найдите адрес, на который пришла ошибка, — шаг 1.
- Проверьте, что файл лежит на сервере, — шаг 2.
- Сверьте путь к PHP-FPM с папкой сайта — шаг 3.
Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.
Что значит это сообщение
[Mon Oct 19 19:52:11.025987 2026] [proxy_fcgi:error] [pid 2345:tid 139872512345664] [client 203.0.113.10:51234] AH01071: Got error 'Primary script unknown'Got error значит «получена ошибка»: в кавычках Apache передаёт сообщение PHP-FPM — программы, которая выполняет PHP-файлы. Primary script unknown — «главный скрипт не найден»: файла по пути, который передал Apache, нет. Посетитель видит страницу с одной строкой File not found и ответ 404.
Ошибка бывает только там, где PHP работает через PHP-FPM. В нашей инструкции PHP для Apache PHP подключён модулем Apache — там этой ошибки нет.
Другие тексты в кавычках
| Текст после Got error | В браузере | Что значит |
|---|---|---|
| Primary script unknown | File not found. | Файла по переданному пути нет |
| Unable to open primary script: … (Permission denied) | Access denied. | Файл есть, но PHP-FPM не хватает прав, чтобы его открыть |
| Unable to open primary script: … с другой причиной в скобках | No input file specified. | Файл не открылся по другой причине |
Если после Got error стоит PHP message:, файл нашёлся, а ошибку или предупреждение выдал сам PHP-скрипт — читайте текст после этих слов. Если при этом сайт отвечает 500, разбирайтесь по странице 500 Internal Server Error.
Шаг 1. Найдите адрес с ошибкой
sudo grep ' 404 ' /var/log/apache2/access.log | tail -n 20Команда покажет последние 20 строк журнала запросов с ответом 404: в кавычках — метод и адрес запроса, например GET /index.php HTTP/1.1.
Если это адреса вроде /wp-login.php, которых на вашем сайте нет и не было, их перебирают роботы: таких файлов нет, и ошибка для них ожидаема — чинить ничего не нужно. Если в списке адреса ваших страниц — переходите к шагу 2.
Шаг 2. Проверьте, что файл есть
ls -la /var/www/example.com/Вместо /var/www/example.com/ — папка сайта, а если адрес ведёт во вложенную папку — она. Файл из адреса — например, index.php — должен лежать в ней, имя должно совпадать до буквы.
Если файла нет, загрузите его — как, рассказано в инструкции Как разместить сайт на VPS. Если файл есть, ищите ошибку в пути — шаг 3.
Шаг 3. Найдите, куда Apache передаёт PHP-файлы
sudo grep -Rn -e ProxyPassMatch -e SetHandler /etc/apache2/sites-enabled/ /etc/apache2/conf-enabled/Команда покажет строки, которые отправляют PHP-файлы в PHP-FPM, — с именем файла и номером строки. Бывает два варианта.
Строка ProxyPassMatch
ProxyPassMatch "^/.*\.php(/.*)?$" "fcgi://127.0.0.1:9000/var/www/example.com"Путь после адреса PHP-FPM — здесь /var/www/example.com — это папка на сервере. Apache приписывает к ней адрес запроса: для example.com/index.php PHP-FPM получит путь /var/www/example.com/index.php. Этот путь должен совпадать с папкой из строки DocumentRoot. Если в строке ProxyPassMatch осталась старая папка или опечатка, PHP-FPM ищет файл не там.
Адрес 127.0.0.1:9000 в примере условный — оставьте адрес PHP-FPM, который стоит у вас. Откройте файл, который показала команда grep, — sudo nano и путь к файлу — и поправьте папку. Сохраните файл — Ctrl+O, Enter, затем Ctrl+X — и проверьте настройки: sudo apache2ctl configtest. В конце ответа должно быть Syntax OK. Тогда примените их: sudo systemctl reload apache2.
Строка SetHandler
<FilesMatch "\.php$">
SetHandler "proxy:fcgi://127.0.0.1:9000"
</FilesMatch>Вместо адреса 127.0.0.1:9000 у вас может стоять путь к файлу-сокету. В этом варианте Apache сам находит файл в папке DocumentRoot и передаёт PHP-FPM путь к нему. Значит, Primary script unknown здесь — это файл, которого нет по адресу: вернитесь к шагу 2 и проверьте строку DocumentRoot.
Access denied — не хватает прав или не тот файл
Если в журнале Unable to open primary script и (Permission denied), файл есть, но PHP-FPM не может его прочитать. Как и Apache, PHP-FPM в Ubuntu работает от имени www-data. Найдите папку без права входа командой namei — как на странице AH00035: search permissions are missing, — и выровняйте права: папкам 755, файлам 644 — подробнее.
Если Access denied приходит на адрес, который не заканчивается на .php, — например, на картинку, — в PHP-FPM попал не PHP-файл. PHP-FPM выполняет только файлы с расширениями из списка security.limit_extensions в своих настройках, остальные отклоняет. Проверьте шаблон в строке ProxyPassMatch или FilesMatch: в нём должно быть \.php.
Как проверить
Откройте адрес в браузере заново — вместо File not found должна открыться страница. Новых записей AH01071 для этого адреса в журнале быть не должно: sudo tail -n 20 /var/log/apache2/error.log.
Похожие ошибки
| Сообщение | Чем отличается |
|---|---|
| File not found в nginx | Та же ошибка PHP-FPM, но сайт на nginx |
| AH00035: search permissions are missing | Права не пускают в папку сам Apache — ответ 403 |
| AH01276: Cannot serve directory | В папке нет индексного файла |
| AH00112: DocumentRoot does not exist | Нет самой папки сайта |
Источники
- Исходный код Apache 2.4.58: mod_proxy_fcgi.c — запись AH01071: Got error передаёт сообщения PHP-FPM.
- Документация Apache: mod_proxy_fcgi — ProxyPassMatch и SetHandler для PHP-FPM; путь после адреса PHP-FPM — путь к файлам на сервере.
- Документация Apache: ProxyPassMatch — если в адресе нет $1 и других ссылок на шаблон, Apache приписывает к нему адрес запроса.
- Исходный код PHP 8.3.6: fpm_main.c — Primary script unknown и ответ File not found, Unable to open primary script, ответ Access denied.
- Исходный код PHP 8.3.6: fpm_php.c — проверка security.limit_extensions: файлы с другими расширениями PHP-FPM не выполняет.
Сверено 19 октября 2026 года.
Что почитать дальше
- PHP для Apacheкак подключить PHP к Apache.
- Права на файлы сайта на VPSпапкам 755, файлам 644.
- Все ошибки Apacheгде искать причину и что значат сообщения.