Конспект: синтаксис и контексты

Язык конфига состоит всего из двух конструкций - и из правила о том, где каждая директива вообще разрешена.

Две конструкции

worker_processes auto;          # простая директива: имя, аргументы, ;

server {                        # блочная: открывает контекст
    listen 80;
    server_name shop.local;
}

Аргументы читаются подряд, пока не встретится ; или {. Из этой одной строчки следует всё остальное поведение языка, включая сообщения об ошибках.

Контексты

main (весь файл)
├── events
├── http
│   ├── server
│   │   └── location  →  вложенный location
│   └── upstream
└── stream

Каждая директива разрешена только в своих контекстах - это первое, что смотрят в документации (строка Context:). Правило выбора: ставь директиву в самый узкий контекст, где она разрешена.

Мелочи, которые экономят время

Четыре сообщения об одной пропущенной ;

Во всех четырёх случаях номер строки указывает на место, где разбор остановился, а не где сделана ошибка.

Ловушки джокера

• Номер строки в ошибке - не место ошибки. Nginx называет строку, на которой понял, что что-то не так. Смотри выше.
• Конфиг прошёл проверку, а сайт отдаёт 404 на всё. Директива-список съела соседнюю строку. Быстрая проверка - nginx -T | grep server_name.
• $1-$9 в значении заголовка молча пустые. Это ссылки на скобочные группы регулярки, а не текст. Знак доллара в значении заводится через geo $dollar { default "$"; }.
• nginx -t печатает syntax is ok и тут же падает. Синтаксис и смысл проверяются разными этапами: читать надо последнюю строку вывода.