nginx и PHP: File not found и Primary script unknown — что делать

1. Проверьте блок PHP в настройках сайта

Откройте файл настроек сайта — вместо example.com подставьте имя своего файла из папки /etc/nginx/sites-available/:

sudo nano /etc/nginx/sites-available/example.com

Найдите блок для PHP: нажмите Ctrl+W, введите \.php и нажмите Enter. Для Ubuntu он должен выглядеть так:

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

Если вместо include snippets/fastcgi-php.conf; стоит include fastcgi_params; — причина в этом: в файле fastcgi_params нет строки SCRIPT_FILENAME, и PHP-FPM не получает путь к файлу. Замените строку на include snippets/fastcgi-php.conf; — этот файл подключает fastcgi.conf, где путь задан.

Если в блоке есть своя строка fastcgi_param SCRIPT_FILENAME с готовой папкой, например /var/www/html$fastcgi_script_name, — папка в ней должна совпадать с папкой сайта. Проще удалить эту строку: snippets/fastcgi-php.conf задаёт путь сам, от root.

Сохраните файл — Ctrl+O, Enter, затем Ctrl+X — и проверьте настройки: sudo nginx -t. В ответе должны быть слова syntax is ok и test is successful. Тогда примените их: sudo systemctl reload nginx.

2. Проверьте, где задан root

Строка root должна стоять в блоке server, а не внутри location /:

server {
    server_name example.com;
    root /var/www/example.com;
    index index.php index.html;

    location / {
        try_files $uri $uri/ =404;
    }

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

Если root задан только внутри location /, блок для PHP его не видит и берёт папку по умолчанию — html в папке nginx. Перенесите строку root на уровень server, как в примере. Сохраните файл — Ctrl+O, Enter, затем Ctrl+X — и проверьте настройки: sudo nginx -t. В ответе должны быть слова syntax is ok и test is successful. Тогда примените их: sudo systemctl reload nginx.

3. Проверьте доступ к папкам

PHP-FPM работает от своего пользователя — в Ubuntu это www-data. Чтобы найти файл, ему нужно право входа (x) в каждую папку на пути к файлу. Посмотрите права всех папок на пути:

sudo namei -l /var/www/example.com/index.php

Как читать ответ и что исправить — Нет прав на файлы. Если файлы сайта лежат в домашней папке, например /home/ivan/site, закрытой для других пользователей, перенесите сайт в /var/www/.

Если nginx и PHP-FPM работают в разных контейнерах Docker, папка сайта должна быть доступна в обоих по одному и тому же пути: nginx передаёт путь, а ищет файл PHP-FPM.