Esta extensión provee filtros los cuales pueden ser utilizados para validar o sanear datos. Esto es especialmente útil cuando la fuente de datos contiene datos desconocidos (o externos), como entradas facilitadas por el usuario. Por ejemplo, estos datos pueden venir de un formulario HTML.
Principalmente hay dos tipos de filtrado: validación y saneamiento.
Un filtro de validación se usa para comprobar si los datos cumplen ciertos criterios.
Estos filtros son identificados por las constantes
FILTER_VALIDATE_*
.
Por ejemplo, el filtro FILTER_VALIDATE_EMAIL
puede ser usado para determinar si los datos son una dirección de correo válida.
Sin embargo, nunca alterará los datos de entrada.
El saneamiento, por otro lado, "limpiará" los datos,
por lo tanto puede alterar los datos de entrada añadiendo o eliminando caracteres.
Estos filtros son identificados por las constantes
FILTER_SANITIZE_*
.
Por ejemplo, el filtro FILTER_SANITIZE_EMAIL
eliminará
los caracteres que no son apropiados para una dirección de correo electrónico.
Sin embargo, los datos saneados no son validados para comprobar si son
una dirección de correo válida.
Muchos filtros soportan flags opcionales que pueden ajustar
el comportamiento del filtro.
Estos flags son identificados por las constantes
FILTER_FLAG_*
.
Por ejemplo, usando el flag FILTER_FLAG_PATH_REQUIRED
con
el filtro de validación FILTER_VALIDATE_URL
requiere que la URL tenga una ruta
(por ejemplo, /foo
en https://example.org/foo
).