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