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).