include

Описание

Директива 'include' предназначена для повышения модульности и удобства сопровождения конфигурации NGINX путем включения других файлов конфигурации. Это помогает разбивать большие файлы конфигурации на управляемые части, облегчая их обновление и организацию. Используя директиву 'include', пользователи могут определить общие настройки в отдельном файле и включать их там, где это необходимо в разных контекстах конфигурации, способствуя принципу DRY (Don't Repeat Yourself). Аргумент для директивы 'include' состоит из пути к одному или нескольким файлам конфигурации. Путь может быть указан как абсолютный или как относительный путь от текущего рабочего каталога. Поддерживаются также подстановочные символы, позволяющие включать несколько файлов, соответствующих заданному шаблону. Когда NGINX обрабатывает основной файл конфигурации, он разрешает и читает файлы, указанные в директиве 'include', в том порядке, в котором они указаны. Директивы внутри этих файлов затем объединяются с текущим контекстом, позволяя им соответствующим образом влиять на настройки конфигурации. Файлы конфигурации, включаемые с помощью этой директивы, могут определять различные аспекты NGINX, такие как блоки location, настройки server или конфигурации upstream. Однако следует соблюдать осторожность, чтобы избежать конфликтов с уже существующими настройками в основном файле конфигурации. Если включённый файл содержит директивы, которые изменяют уже определённые настройки, последнее определённое значение в объединённой конфигурации будет иметь приоритет. Такая гибкость делает директиву 'include' мощным инструментом для эффективной структуризации сложных конфигураций NGINX.

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

# Example of using the 'include' directive
include /etc/nginx/conf.d/*.conf;