fastcgi_param

Задает параметры для запросов FastCGI в NGINX. — NGINX HTTP Core

fastcgi_param
httpserverlocation
Синтаксисfastcgi_param name value; [value];
По умолчаниюnone
Контекстhttp, server, location
МодульNGINX HTTP Core
Аргументы2-3

Описание

Директива `fastcgi_param` используется в конфигурации NGINX для установки переменных окружения, которые передаются серверам FastCGI. По умолчанию она применяется в контекстах, таких как `http`, `server` и `location`, что обеспечивает гибкость при настройке поведения FastCGI для разных маршрутов приложения. Директива принимает два или три параметра: первый параметр — имя переменной, второй — её значение, а опционально третий параметр может указывать, должно ли значение браться из заголовка запроса. Когда директива `fastcgi_param` используется, она по сути передаёт информацию, относящуюся к обработке запроса FastCGI. Например, можно задать параметры, такие как `SCRIPT_FILENAME`, который указывает скрипт для выполнения на сервере FastCGI. Эта директива гарантирует, что необходимые переменные доступны приложению FastCGI для корректного ответа на запрос пользователя. Она особенно полезна, когда требуется явно определить, как определённые переменные должны обрабатываться логикой приложения FastCGI. Важно отметить, что `fastcgi_param` перезаписывает любые параметры с тем же именем, уже заданные в конфигурации, что позволяет точно контролировать окружение, передаваемое обработчику FastCGI, и тем самым избегать конфликтов или непредвиденного поведения значений переменных.

Пример конфига

location ~ \.php$ {
    include fastcgi_params;
    fastcgi_pass 127.0.0.1:9000;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}

Убедитесь, что имена переменных корректны и указаны верно, так как опечатки могут привести к непредсказуемому поведению.

Будьте осторожны при перезаписи существующих параметров; при необходимости явно задавайте нужные значения.