ngx_http_user_agent_module

This module can analyse the header of User-Agent.

This module is enabled by default. It can be disabled with the --without-http_user_agent_module configuration parameter.

Examples

http {
    user_agent $ngx_browser {
        default                     unknown;

        greedy                      Firefox;

        Chrome      18.0+           chrome18;
        Chrome      17.0~17.9999    chrome17;
        Chrome      5.0-            chrome_low;
    }
}

Directives

Syntax: user_agent $variable_name Default: none Context: http

Set a variable whose value depends on the value of user_agent string.This block contains three parts, default, greedy and analysis items.

Syntax: default value Default: none Context: user_agent block

The default variable value if the user_agent string can't match any of the item.

Syntax: greedy keyword Default: none Context: user_agent block

If the keyword is greedy, it will continue to scan the user-agent string until it can find other item which is not greedy. If it can't find any other item, this keyword will be returned at last.

e.g.: "Mozilla/5.0 (Windows NT 5.1) AppleWebKit/535.1 (KHTML, like Gecko) Chrome/13.0.782.112 Safari/535.1",this user_agent string will return Chrome13,if configuration file like this:

greedy                  Safari;
Chrome  13.0~13.9999    chrome13;

Syntax: keyword version value Default: none Context: user_agent block

• keyword: This is the word we want to match from the user_agent string.* version: the version of keyword.

• version+:greater or equal should be matched;version-:less or equal should be matched; version:equal should be matched;* version1~version2:matched in [version1,version2];

• value:If this item is matched, the value will be filled to the defined variable.