Browser#

O módulo cria variáveis cujos valores dependem do valor do campo de cabeçalho de requisição User-Agent.

Variáveis#

$modern_browser#

igual ao valor definido pela diretiva modern_browser_value, se um navegador foi identificado como moderno;

$ancient_browser#

igual ao valor definido pela diretiva ancient_browser_value, se um navegador foi identificado como antigo;

$msie#

igual a "1" se um navegador foi identificado como MSIE de qualquer versão.

Exemplo de Configuração#

Escolhendo um arquivo de índice:#

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;

Redirecionamento para navegadores antigos:#

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

Diretivas#

ancient_browser#

Sintaxe

ancient_browser string ...;

Padrão

—

Contexto

http, server, location

Se qualquer uma das substrings especificadas for encontrada no campo de cabeçalho de requisição User-Agent, o navegador será considerado antigo. A string especial "netscape4" corresponde à expressão regular "^Mozilla/[1-4]".

ancient_browser_value#

Sintaxe

ancient_browser_value string;

Padrão

ancient_browser_value 1;

Contexto

http, server, location

Define um valor para a variável $ancient_browser.

modern_browser#

Sintaxe

modern_browser browser version;

modern_browser unlisted;

Padrão

—

Contexto

http, server, location

Especifica uma versão a partir da qual um navegador é considerado moderno. Um navegador pode ser qualquer um dos seguintes: msie, gecko (navegadores baseados no Mozilla), opera, safari, ou konqueror.

As versões podem ser especificadas nos seguintes formatos: X, X.X, X.X.X, ou X.X.X.X. Os valores máximos para cada um dos formatos são 4000, 4000.99, 4000.99.99, e 4000.99.99.99, respectivamente.

O valor especial unlisted especifica para considerar um navegador como moderno se ele não foi listado pelas diretivas modern_browser e ancient_browser. Caso contrário, tal navegador é considerado antigo. Se uma requisição não fornecer o campo User-Agent no cabeçalho, o navegador é tratado como não listado.

modern_browser_value#

Sintaxe

modern_browser_value string;

Padrão

modern_browser_value 1;

Contexto

http, server, location

Define um valor para a variável $modern_browser.