Browser模块

摘要

This module creates variables, the values of which depend on the request header "User-agent":

本模块的变量基于请求头(header)中的"User-agent":

  • $modern_browser - is equal to the value, assigned by directive modern_browser_value, if browser is identified as an modern browser;
  • $ancient_browser - 当等于指定给modern_browser_value的浏览器时,这个浏览器被认定为新版的浏览器;
  • $ancient_browser - is equal to the value, assigned by directive ancient_browser_value, if browser is identified as an old browser;
  • $ancient_browser - 当等于指定给ancient_browser_value的浏览器时,这个浏览器被认定为老版的浏览器;
  • $msie - is equal 1, if browser is identified as MSIE with any version;
  • $msie - 当浏览器为MSIE的任何版本时,这个值等于1;
    If you don't need this module add —without-http_browser_module parameter to the ./configure call, at compile time.

如果不需要这个模块时,在编译的时候加上 —without-http_browser_module.

Example configuration 例如配置

Selection of the index file:

选择索引文件:

  1. modern_browser_value "modern.";
  2. modern_browser msie 5.5;
  3. modern_browser gecko 1.0.0;
  4. modern_browser opera 9.0;
  5. modern_browser safari 413;
  6. modern_browser konqueror 3.0;
  7. index index.${modern_browser}html index.html;

Redirect for the old browsers:

定义老的浏览器:

  1. modern_browser msie 5.0;
  2. modern_browser gecko 0.9.1;
  3. modern_browser opera 8.0;
  4. modern_browser safari 413;
  5. modern_browser konqueror 3.0;
  6. modern_browser unlisted;
  7. ancient_browser Links Lynx Netscape4;
  8. if ($ancient_browser){
  9. rewrite ^ /ancient.html;
  10. }

指令

ancient_browser

syntax:*ancient_browser line [ line… ]*

default:*no*

context:*http, server, location*

Directive assigns the substrings, during presence of which in the line "User-agent", browser are considered as old. Special line "netscape4" corresponds to regular expression "^Mozilla/[1-4] ".

ancient_browser_value

syntax:*ancient_browser_value line*

default:*ancient_browser_value 1*

context:*http, server, location*

Directive assigns value for the variables $ancient_browser.

定义 $ancient_browser的变量值.

modern_browser

syntax:*modern_browser browser version|unlisted*

default:*no*

context:*http, server, location*

Directive assigns which version of the browser is to be considered as modern. As browser you can assign the values msie, gecko (Mozilla-based browsers) opera, safari, konqueror.

Of versions it is possible to assign in size X, X.X, X.X.X, or X.X.X.X. maximum values for each of their sizes respectively - 4000, 4000.99, 4000.99.99, and 4000.99.99.99.

Special value "unlisted" indicates to consider modern browser, not described by the modern_browser and ancient_browser directives. Otherwise the neperechislennyy browser will be considered become obsolete. If the headers do not contain "User-agent", the browser is considered neperechislennym.

modern_browser_value

syntax:*modern_browser_value line*

default:*modern_browser_value 1*

context:*http, server, location*

Directive assigns value for the variables $modern_browser.

定义$modern_browser的变量值.

References

Original Documentation new since 26.09.2006 version 0.4.3

原文: https://wizardforcel.gitbooks.io/nginx-doc/content/Text/3.6_browser.html