Cette extension fournit des filtres permettant de valider ou de purifier des données. Cela est particulièrement utile lorsque la source des données contient des informations inconnues (ou étrangères), comme les entrées fournies par les utilisateurs. Par exemple, ces données peuvent provenir d’un formulaire HTML.
Il y a deux manières de filtrer : la validation et la purification.
Un filtre de validation est utilisé pour vérifier si les données répondent à certains critères.
Ces filtres sont identifiés par les constantes
FILTER_VALIDATE_*
.
Par exemple, le filtre FILTER_VALIDATE_EMAIL
peut être utilisé pour déterminer si les données sont une adresse email valide.
Cependant, il n'altérera jamais les données d'entrée.
La purification, en revanche, va "nettoyer" les données,
ce qui peut entraîner une modification des données d'entrée en ajoutant ou supprimant des caractères.
Ces filtres sont identifiés par les constantes
FILTER_SANITIZE_*
.
Par exemple, le filtre FILTER_SANITIZE_EMAIL
supprimera
les caractères qui ne sont pas appropriés pour une adresse email.
Cependant, les données purifiées ne sont pas validées pour vérifier si elles constituent une
adresse email valide.
La plupart des filtres prennent en charge des options
sous forme de drapeaux permettant d’ajuster leur comportement.
Ces drapeaux sont identifiés par les constantes
FILTER_FLAG_*
.
Par exemple, utiliser le drapeau FILTER_FLAG_PATH_REQUIRED
avec
le filtre de validation FILTER_VALIDATE_URL
exige que l'URL comporte un chemin
(par exemple, /foo
dans https://example.org/foo
).