set_local_today
Директива 'set_local_today' задаёт локальную переменную со значением текущей даты в указанном формате и области видимости.
Описание
Директива 'set_local_today' используется в конфигурациях NGINX для присвоения локальной переменной, содержащей текущую дату, форматированную в виде строки. Она особенно полезна в ситуациях, когда нужно пометить или залогировать запросы датой сегодняшнего дня, особенно при динамической генерации контента. Значение, присваиваемое 'set_local_today', определяется во время обработки запроса, что гарантирует соответствие даты локальным настройкам времени сервера.
Директива ожидает один аргумент: спецификатор формата, который указывает, как должна быть отформатирована дата (например, 'YYYY-MM-DD'). Директиву можно размещать в различных контекстах, таких как http, server, location, а также внутри if блоков в этих контекстах, что обеспечивает гибкое использование в разных конфигурациях. Как локальная переменная, она ограничена областью запроса и не влияет и не будет видна другим запросам, обрабатываемым сервером.
С точки зрения эксплуатации, администраторам важно учитывать часовой пояс сервера в конфигурации NGINX, чтобы возвращаемая директивой дата была точной. Строка формата в значительной степени следует общим соглашениям strftime, позволяя настраивать формат в соответствии с конкретными требованиями или предпочтениями.
Пример конфига
location /example {
set_local_today $today "%Y-%m-%d";
add_header X-Today $today;
}Использование неверных строк формата может привести к непредвиденным результатам или ошибкам.
Убедитесь, что часовой пояс сервера установлен правильно для получения точной даты.
Локальные переменные недоступны в других контекстах; убедитесь, что используете их в правильной области видимости.