<!-- review: finished -->

<a id="http-browser"></a>

# Browser

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

<a id="variables"></a>

## Variáveis

<a id="v-modern-browser"></a>

### `$modern_browser`

igual ao valor definido pela diretiva [modern_browser_value](#modern-browser-value), se um navegador foi identificado como moderno;

<a id="v-ancient-browser"></a>

### `$ancient_browser`

igual ao valor definido pela diretiva [ancient_browser_value](#ancient-browser-value), se um navegador foi identificado como antigo;

<a id="v-msie"></a>

### `$msie`

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

<a id="configuration-example-9"></a>

## Exemplo de Configuração

<a id="choosing-an-index-file"></a>

### Escolhendo um arquivo de índice:

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

<a id="redirection-for-old-browsers"></a>

### Redirecionamento para navegadores antigos:

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

<a id="directives-10"></a>

## Diretivas

<a id="index-0"></a>

<a id="id1"></a>

### ancient_browser

| [Sintaxe](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)   | `ancient_browser` string ...;   |
|-------------------------------------------------------------------------------------------|---------------------------------|
| Padrão                                                                                    | —                               |
| [Contexto](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)  | 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]".

<a id="index-1"></a>

<a id="ancient-browser-value"></a>

### ancient_browser_value

| [Sintaxe](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)   | `ancient_browser_value` string;   |
|-------------------------------------------------------------------------------------------|-----------------------------------|
| Padrão                                                                                    | `ancient_browser_value 1;`        |
| [Contexto](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)  | http, server, location            |

Define um valor para a variável [$ancient_browser](#v-ancient-browser).

<a id="index-2"></a>

<a id="id4"></a>

### modern_browser

| [Sintaxe](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)   | `modern_browser` browser version;<br/><br/>`modern_browser` `unlisted`;   |
|-------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|
| Padrão                                                                                    | —                                                                         |
| [Contexto](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)  | 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](#id1). 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.

<a id="index-3"></a>

<a id="modern-browser-value"></a>

### modern_browser_value

| [Sintaxe](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)   | `modern_browser_value` string;   |
|-------------------------------------------------------------------------------------------|----------------------------------|
| Padrão                                                                                    | `modern_browser_value 1;`        |
| [Contexto](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile)  | http, server, location           |

Define um valor para a variável [$modern_browser](#v-modern-browser).