perl_require

Описание

Директива `perl_require` позволяет указать модуль Perl, который будет загружен во время выполнения в контексте NGINX. Эта директива полезна, когда вы хотите расширить функциональность NGINX с помощью пользовательского кода на Perl, позволяя управлять различными аспектами конвейера обработки запросов с помощью скриптов. Аргумент, ожидаемый этой директивой, — это путь к модулю Perl, который может быть указан как относительным, так и абсолютным. Процесс загрузки выполняется только один раз, на этапе инициализации сервера NGINX, что гарантирует доступность указанного модуля на протяжении всего жизненного цикла сервера. При задании этой директивы необходимо убедиться, что указанный модуль правильно оформлен и что выполнены все зависимости, требуемые модулем Perl. В случае неудачной загрузки модуля NGINX записывает ошибку и не запускается, поэтому критически важно тестировать и проверять корректность пути и содержимого модуля. Поскольку эта директива работает в контексте `http`, она влияет на весь сервер и все конфигурации, вложенные в этот контекст, позволяя централизованно управлять скриптами на Perl, которые могут помогать в обработке запросов в нескольких location или server blocks.

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

http {
    perl_require /path/to/your/module.pm;
}