Конспект: переменные

Переменные - способ написать конфиг, который зависит от запроса. Вычисляются на каждый запрос и в момент обращения, а не при старте.

Десять, которые нужны каждый день

Значения для GET /catalog/42?sort=price с заголовком Host: Shop.Local:80.

Два правила, снимающие половину вопросов

1. $uri меняется, $request_uri - нет. После rewrite или try_files $uri уже другой. Поэтому редирект пишут так:

return 301 https://$host$request_uri;

2. Любой заголовок запроса доступен как $http_имя (имя в нижнем регистре, дефисы → подчёркивания). Заголовки ответа - $sent_http_имя.

Свои переменные

set - в server, location и if. На уровне http его нет: там ещё нет обработки запроса, и для этого уровня существует map.

map $http_user_agent $is_bot {
    default   0;
    "~*bot"   1;
}

Отладочный приём

add_header X-Debug-Uri "$uri | $request_uri | $host" always;

Не понимаешь, что nginx видит - выведи это в заголовок и посмотри curl -I. Убрать перед выкладкой обязательно: $http_cookie в заголовке ответа - утечка.

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

• Редирект через $uri вместо $request_uri молча теряет строку запроса: ?utm_source=mail пропадает вместе со статистикой рассылки. Симптом плавающий - на страницах без параметров всё работает.
• unknown "…" variable приходит без номера строки. Искать опечатку в имени придётся самому: nginx -T | grep -n '\$имя'.
• $1-$9 заняты скобочными группами регулярок и вне регулярки пусты. Строка "цена $5 рублей" отдаст цена рублей.
• Значение спрашивают в момент использования, и раньше времени его нет. $status на фазе rewrite равен 000, а $body_bytes_sent в add_header - нулю: тело ещё не отправлено. Сам $status в add_header при этом верный.