perl_require
`perl_require` 指令在 NGINX 配置中加载一个 Perl 模块以供使用。 — NGINX HTTP Core
perl_require
http
语法perl_require module;
默认值none
上下文http
模块NGINX HTTP Core
参数1
说明
`perl_require` 指令允许用户指定一个在运行时由 NGINX 加载的 Perl 模块。此指令在你希望使用自定义 Perl 代码扩展 NGINX 功能、并对请求处理流程的各个方面进行脚本化控制时非常有用。该指令期望的参数是 Perl 模块的路径，可以是相对路径或绝对路径。加载过程仅在 NGINX 服务器的初始化阶段发生一次，确保指定的模块在服务器其余生命周期内可用。 在定义此指令时，必须确保指定的模块格式正确且满足该 Perl 模块所需的任何依赖项。如果加载模块失败，NGINX 会记录错误并无法启动，因此对模块路径和内容进行充分的测试与验证至关重要。因为此指令在 `http` 上下文中生效，它会影响整个服务器以及该上下文内的所有嵌套配置，从而允许集中管理可能用于跨多个 locations 或 server blocks 处理请求的 Perl 脚本。
配置示例
http {
perl_require /path/to/your/module.pm;
}⚠
Perl 模块的路径必须有效；否则 NGINX 将无法启动。
⚠
确保服务器上已安装必要的 Perl 模块。
⚠
检查 NGINX 错误日志中与模块加载问题相关的消息。