Spec-Zone.ru › nginx

Модуль ngx_http_browser_module

  • Пример конфигурации
  • Директивы
  • ancient_browser
  • ancient_browser_value
  • modern_browser
  • modern_browser_value

Модуль ngx_http_browser_module создаёт переменные, значения которых зависят от значения поля заголовка запроса «User-Agent»:

$modern_browser
равно значению, заданному директивой modern_browser_value, если браузер был идентифицирован как современный;
$ancient_browser
равно значению, заданному директивой ancient_browser_value, если браузер был идентифицирован как устаревший;
$msie
равно «1», если браузер был идентифицирован как MSIE любой версии.

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

Выбор файла индекса:

modern_browser_value "modern.";

modern_browser msie      5.5;
modern_browser gecko     1.0.0;
modern_browser opera     9.0;
modern_browser safari    413;
modern_browser konqueror 3.0;

index index.${modern_browser}html index.html;

Перенаправление для старых браузеров:

modern_browser msie      5.0;
modern_browser gecko     0.9.1;
modern_browser opera     8.0;
modern_browser safari    413;
modern_browser konqueror 3.0;

modern_browser unlisted;

ancient_browser Links Lynx netscape4;

if ($ancient_browser) {
    rewrite ^ /ancient.html;
}

Директивы

Синтаксис: ancient_browser string ...;
По умолчанию: —
Контекст: http, server, location

Если любой из указанных подстрок найден в поле заголовка запроса «User-Agent», браузер считается устаревшим. Специальная строка «netscape4» соответствует регулярному выражению «^Mozilla/[1-4]».

Синтаксис: ancient_browser_value string;
По умолчанию: ancient_browser_value 1;
Контекст: http, server, location

Устанавливает значение для переменных $ancient_browser.

Синтаксис: modern_browser browser version;
modern_browser unlisted;
По умолчанию: —
Контекст: http, server, location

Указывает версию, начиная с которой браузер считается современным. Браузер может быть одним из следующих: msie, gecko (браузеры на основе Mozilla), opera, safari, или konqueror.

Версии могут быть указаны в следующих форматах: X, X.X, X.X.X или X.X.X.X. Максимальные значения для каждого из форматов соответственно равны 4000, 4000.99, 4000.99.99 и 4000.99.99.99.

Специальное значение unlisted указывает на то, что браузер считается современным, если он не был указан директивами modern_browser и ancient_browser. В противном случае браузер считается устаревшим. Если запрос не содержит поля «User-Agent» в заголовке, браузер считается не указанным.

Синтаксис: modern_browser_value string;
По умолчанию: modern_browser_value 1;
Контекст: http, server, location

Устанавливает значение для переменных $modern_browser.

© 2002-2021 Igor Sysoev
© 2011-2024 Nginx, Inc.
Licensed under the BSD License.
https://nginx.org/en/docs/http/ngx_http_browser_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API