# Filtragem de dados

# Introdução

Esta extensão fornece filtros que podem ser usados para validar ou sanitizar dados. Isto é especialmente útil quando a fonte contém dados desconhecidos (ou externos), como dados enviados pelo usuário. Por exemplo, esses dados podem vir de um formulário HTML.

Há dois tipos principais de filtragem: validação e higienização.

Um filtro de validação é utilizado para verificar se os dados cumprem certos critérios. Estes filtros são identificados pelas constantes `FILTER_VALIDATE_*`. Por exemplo, a constante `FILTER_VALIDATE_EMAIL` pode ser usada para determinar se o dado é um endereço de e-mail válido. Entretanto, ele nunca alterará os dados de entrada.

A sanitização, por outro lado, "limpará" os dados, portanto pode alterar os dados de entrada adicionando ou removendo caracteres. Estes filtros são identificados pelas constantes `FILTER_SANITIZE_*`. Por exemplo, o filtro `FILTER_SANITIZE_EMAIL` removerá caracteres que são inadequados para um endereço de e-mail. Entretanto, os dados sanitizados não são validados para verificar se o endereço é válido.

A maioria dos filtros suporta sinalizadores opcionais que podem ajustar o comportamento do filtro. Estes sinalizadores são identificados pelas constantes `FILTER_FLAG_*`. Por exemplo, usar `FILTER_FLAG_PATH_REQUIRED` com um filtro de validação `FILTER_VALIDATE_URL` irá requerer que um URL tenha um caminho (por exemplo, `/foo` em `https://example.org/foo`).

- Instalação/Configuração
  - Instalação
  - Configurações em Execução
- Constantes predefinidas
- Exemplos
  - Validação
  - Sanitização
- Funções da Filter
  - filter_has_var — Verifica se uma variável de um tipo especificado existe
  - filter_id — Retorna o ID de filtro pertencente a um filtro nomeado
  - filter_input — Obtém uma variável externa específica por nome e filtra-a opcionalmente
  - filter_input_array — Obtem variáveis externas e opcionalmente as filtra
  - filter_list — Retorna a lista de todos os filtros suportados
  - filter_var — Filtra uma variável com um filtro especificado
  - filter_var_array — Obtêm e opcionalmente filtra múltiplas variáveis
- Filter\FilterException — A classe Filter\FilterException
- Filter\FilterFailedException — A classe Filter\FilterFailedException

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open