break

Описание

Директива 'break' используется внутри блоков location или if в конфигурации NGINX, чтобы прекратить оценку всех последующих правил rewrite или вложенных блоков location. При срабатывании она фактически изменяет поток обработки запроса, позволяя администраторам контролировать, должен ли запрос продолжать обработку другими правилами или обработчиками. Эта директива полезна для реализации условной логики на основе определённых критериев, таких как состояние URI или параметры запроса. Когда директива 'break' встречается во время обработки запроса, сервер NGINX перестаёт оценивать любые последующие директивы rewrite, которые следуют за ней в том же контексте. После вызова 'break' NGINX продолжает обработку текущего блока конфигурации, возможно пропуская другие определённые поведения или обработчики, которые могут повлиять на текущий запрос. Она действует как резкое завершение обработки в контролируемой форме, что позволяет упростить и прояснить сложные настройки NGINX. Важно отметить, что директива 'break' не возвращает значений и не принимает параметров. Это строго команда, которая изменяет поток управления. Для её корректного использования в файле конфигурации не требуются прямые аргументы или выражения, что делает её реализацию простой. Однако она в основном применима там, где могут существовать несколько вложенных директив, например в сложных сценариях сопоставления location.

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

location /example {
    if ($arg_param = 'stop') {
        break;
    }
    # Further processing can go here
}