load_module

Описание

Директива `load_module` позволяет пользователям динамически загружать указанный модуль NGINX без перекомпиляции всего бинарного файла NGINX. Эта директива должна находиться в основном контексте конфигурации и принимает один аргумент: путь к файлу разделяемого объекта модуля (обычно с суффиксом .so). Когда рабочий процесс NGINX запускается, эта директива инструктирует NGINX попытаться загрузить модуль, указанный в её аргументе, что позволяет добавить дополнительную функциональность в сервер без необходимости перезапуска или перекомпиляции. Эта директива может быть критически важна для включения опциональных функций или сторонних модулей, расширяющих базовые возможности NGINX, таких как дополнительные механизмы аутентификации или улучшения производительности. Если модуль зависит от других модулей или разделяемых библиотек, эти зависимости также должны быть удовлетворены во время выполнения для успешной загрузки. Пользователям следует убедиться, что указанный файл модуля доступен и процесс NGINX имеет необходимые права для его загрузки. Если загрузка модуля не удастся, NGINX выдаст ошибку и может отказаться от запуска в зависимости от серьёзности возникшей ошибки. Чтобы эффективно использовать эту директиву, обычно её определяют в основном блоке конфигурации NGINX, который обрабатывается перед остальными настройками. Важно отметить, что все зависимости модуля должны быть разрешены заранее, чтобы избежать ошибок во время выполнения.

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

load_module modules/ngx_http_custom_module.so;