load_module

说明

`load_module` 指令允许用户在不重新编译整个 NGINX 二进制文件的情况下动态加载指定的 NGINX 模块。该指令必须放在主配置上下文中，并接受一个参数：要加载模块的共享对象文件的路径（通常以 .so 后缀结尾）。当 NGINX 工作进程启动时，该指令会指示 NGINX 尝试加载其参数中指定的模块，从而在不需重启或重新编译的情况下向服务器加入额外功能。 该指令对于启用可选功能或扩展核心 NGINX 能力的第三方模块（例如额外的认证机制或性能改进）可能至关重要。如果该模块依赖于其他模块或共享库，则这些依赖也必须在运行时满足，加载才能成功。用户应确保指定的模块文件可被访问，并且 NGINX 进程具有加载它所需的权限。如果模块加载失败，NGINX 会报告错误，并可能拒绝启动，具体取决于所遇错误的严重性。 为了有效使用该指令，用户通常在 NGINX 主配置块中定义它，该块会在任何其他配置设置之前被处理。重要的是要注意，应事先解决模块的任何依赖关系以避免运行时错误。

配置示例

load_module modules/ngx_http_custom_module.so;