mirror of
https://github.com/php/doc-fr.git
synced 2026-03-23 22:52:18 +01:00
77 lines
3.1 KiB
XML
77 lines
3.1 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
||
<!-- EN-Revision: 53054bf8decc8648cf2e90a493692a161e2371af Maintainer: yannick Status: ready -->
|
||
<!-- Reviewed: yes -->
|
||
<book xml:id="book.filter" xmlns="http://docbook.org/ns/docbook">
|
||
<?phpdoc extension-membership="bundled" ?>
|
||
<title>Filtrage des données</title>
|
||
<titleabbrev>Filter</titleabbrev>
|
||
|
||
<preface xml:id="intro.filter">
|
||
&reftitle.intro;
|
||
<simpara>
|
||
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 <acronym>HTML</acronym>.
|
||
</simpara>
|
||
<simpara>
|
||
Il y a deux manières de filtrer :
|
||
la <emphasis>validation</emphasis> et la <emphasis>purification</emphasis>.
|
||
</simpara>
|
||
<simpara>
|
||
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
|
||
<constant>FILTER_VALIDATE_<replaceable>*</replaceable></constant>.
|
||
Par exemple, le filtre <constant>FILTER_VALIDATE_EMAIL</constant>
|
||
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.
|
||
</simpara>
|
||
<simpara>
|
||
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
|
||
<constant>FILTER_SANITIZE_<replaceable>*</replaceable></constant>.
|
||
Par exemple, le filtre <constant>FILTER_SANITIZE_EMAIL</constant> 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.
|
||
</simpara>
|
||
<simpara>
|
||
La plupart des filtres prennent en charge des <emphasis>options</emphasis>
|
||
sous forme de drapeaux permettant d’ajuster leur comportement.
|
||
Ces drapeaux sont identifiés par les constantes
|
||
<constant>FILTER_FLAG_<replaceable>*</replaceable></constant>.
|
||
Par exemple, utiliser le drapeau <constant>FILTER_FLAG_PATH_REQUIRED</constant> avec
|
||
le filtre de validation <constant>FILTER_VALIDATE_URL</constant>
|
||
exige que l'<acronym>URL</acronym> comporte un chemin
|
||
(par exemple, <literal>/foo</literal> dans <literal>https://example.org/foo</literal>).
|
||
</simpara>
|
||
</preface>
|
||
|
||
&reference.filter.setup;
|
||
&reference.filter.constants;
|
||
&reference.filter.examples;
|
||
&reference.filter.reference;
|
||
|
||
</book>
|
||
<!-- Keep this comment at the end of the file
|
||
Local variables:
|
||
mode: sgml
|
||
sgml-omittag:t
|
||
sgml-shorttag:t
|
||
sgml-minimize-attributes:nil
|
||
sgml-always-quote-attributes:t
|
||
sgml-indent-step:1
|
||
sgml-indent-data:t
|
||
indent-tabs-mode:nil
|
||
sgml-parent-document:nil
|
||
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
|
||
sgml-exposed-tags:nil
|
||
sgml-local-catalogs:nil
|
||
sgml-local-ecat-files:nil
|
||
End:
|
||
vim600: syn=xml fen fdm=syntax fdl=2 si
|
||
vim: et tw=78 syn=sgml
|
||
vi: ts=1 sw=1
|
||
-->
|