HttpBrowserModule - Revision history

Admin: /* Directives */

2012-05-02T19:27:48Z

‎Directives

Admin: /* Directives */

2012-04-30T06:51:35Z

‎Directives

VBart: /* References */ update link to the original documentation

2012-04-21T15:19:22Z

‎References: update link to the original documentation

Kolbyjack: /* Directives */

2011-04-21T23:06:38Z

‎Directives

New page

= Synopsis =
This module creates variables, the values of which depend on the request 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 - is equal to the value, assigned by directive ancient_browser_value, if browser is identified as an '''old''' browser;
* $msie - is equal '''1''', if browser is identified as MSIE with any version;

If you don't need this module add <code>--without-http_browser_module</code> parameter to the <code>./configure</code> call, at compile time.

Example configuration

Selection of the index file:

<geshi lang="nginx">
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;
</geshi>

Redirect for the old browsers:

<geshi lang="nginx">
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;
}
</geshi>

= Directives =

== ancient_browser ==

{{Directive|name=ancient_browser|args=line [ line... ]|default=none|context=http, server, location|variables=no}}

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

== ancient_browser_value ==

{{Directive|name=ancient_browser_value|args=value|default=1|context=http, server, location|variables=no}}

Directive assigns value for the variables $ancient_browser.

== modern_browser ==

{{Directive|name=modern_browser|args=browser version {{!}} unlisted|default=none|context=http, server, location|variables=no}}

Directive assigns which version of the browser is to be considered as '''modern'''.<BR>
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. <BR>
If the headers do not contain "User-agent", the browser is considered ancient (unless "modern_browser unlisted" is specified).

== modern_browser_value ==

{{Directive|name=modern_browser_value|args=value|default=1|context=http, server, location|variables=no}}

Directive assigns value for the variables $modern_browser.

= Examples =
'''Note''' The use of ancient_browser in the link provided below is broken it should use:
ancient_browser "MSIE 4.0" "MSIE 5.0" "MSIE 5.5" "MSIE 6.0";

[http://gist.github.com/228769 Example of use]: support only recent versions of Chrome, Firefox, Internet Explorer, Safari, Mobile Safari and Palm Pre

= References =
[http://sysoev.ru/nginx/docs/http/ngx_http_browser_module.html Original Documentation] new since 26.09.2006 version 0.4.3

@@ Line 41: / Line 41: @@
 == ancient_browser ==
-<include wikitext nopre src="http://wiki.nginx.org/nginx.org/ngx_http_browser_module/ancient_browser.txt" />
+<include wikitext nopre src="http://wiki.nginx.org/nginx.org/http/ngx_http_browser_module/ancient_browser.txt" />
 Directive assigns the substrings, during presence of which in the line "User-agent", browser are considered as '''old'''.<BR>
@@ Line 47: / Line 47: @@
 == ancient_browser_value ==
-<include wikitext nopre src="http://wiki.nginx.org/nginx.org/ngx_http_browser_module/ancient_browser_value.txt" />
+<include wikitext nopre src="http://wiki.nginx.org/nginx.org/http/ngx_http_browser_module/ancient_browser_value.txt" />
 Directive assigns value for the variables $ancient_browser.
 == modern_browser ==
-<include wikitext nopre src="http://wiki.nginx.org/nginx.org/ngx_http_browser_module/modern_browser.txt" />
+<include wikitext nopre src="http://wiki.nginx.org/nginx.org/http/ngx_http_browser_module/modern_browser.txt" />
 Directive assigns which version of the browser is to be considered as '''modern'''.<BR>
@@ Line 63: / Line 63: @@
 == modern_browser_value ==
-<include wikitext nopre src="http://wiki.nginx.org/nginx.org/ngx_http_browser_module/modern_browser_value.txt" />
+<include wikitext nopre src="http://wiki.nginx.org/nginx.org/http/ngx_http_browser_module/modern_browser_value.txt" />
 Directive assigns value for the variables $modern_browser.

← Older revision		Revision as of 15:19, 21 April 2012
Line 81:		Line 81:

	= References =		= References =
−	[http://~~sysoev~~.ru/~~nginx~~/docs/http/ngx_http_browser_module.html Original Documentation] ~~new since 26.09.2006 version 0.4.3~~	+	[http://nginx.org/en/docs/http/ngx_http_browser_module.html Original Documentation]