Персональный
сайт
Игоря
Сысоева


 
english
 
sysoev.ru
 
nginx
 поехали!    
 документация    
 поддержка    
 изменения    
 скачать    
 ссылки    
 
mod_accel
mod_realip
mod_deflate
программирование
всякая всячина
windows
freebsd
apache
pppd
unix
web
 
обо мне
для писем
для денег
 

Директивы модуля ngx_http_browser_module

 

26.09.2006

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

  • $modern_browser — равна значению, заданному директивой modern_browser_value, если браузер опознан как современный;
  • $ancient_browser — равна значению, заданному директивой ancient_browser_value, если браузер опознан как устаревший;
  • $msie — равна "1", если браузер опознан как MSIE любой версии;

Содержание

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

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

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

    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;
    }

Директивы


syntax: ancient_browser строка [строка ...]
default: нет
context: http, server, location

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


syntax: ancient_browser_value строка
default: ancient_browser_value 1
context: http, server, location

Директива задаёт значение для переменных $ancient_browser.


syntax: modern_browser браузер версия|unlisted
default: нет
context: 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", то браузер считается неперечисленным.


syntax: modern_browser_value строка
default: modern_browser_value 1
context: http, server, location

Директива задаёт значение для переменных $modern_browser.


(C) Игорь Сысоев
http://sysoev.ru