Files
doc-fr/reference/filter/book.xml
2021-09-24 04:13:47 +01:00

74 lines
2.5 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: dff279a1fb1cefe17b594d2058741b308e420a36 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;
<para>
Cette extension filtre les données soit en les validant, soit en
les nettoyant. C'est particulièrement utile lorsque les sources
contiennent des données inconnues, comme les données utilisateurs. Par
exemple, les données pourraient provenir d'un formulaire HTML.
</para>
<para>
Il y a deux moyens de filtre :
la <emphasis>validation</emphasis> et le <emphasis>nettoyage</emphasis>.
</para>
<para>
La <link linkend="filter.filters.validate">Validation</link> sert à vérifier
si une donnée passe certains critères. Par exemple, passer les
critères de <constant>FILTER_VALIDATE_EMAIL</constant> va déterminer si
une donnée est une adresse courriel valide, mais ne va pas modifier la
donnée elle-même.
</para>
<para>
Le <link linkend="filter.filters.sanitize">nettoyage</link> va nettoyer
les données ; par exemple en retirant les caractères indésirables. Par
exemple, passer une donnée à <constant>FILTER_SANITIZE_EMAIL</constant>
va faire disparaître les caractères inappropriés dans une adresse courriel.
D'un autre coté, la donnée n'est pas validée.
</para>
<para>
Des <emphasis>options</emphasis> sont éventuellement utilisées par la
validation et le nettoyage, pour adapter leur comportement à des
besoins spécifiques. Par exemple, avec l'option
<constant>FILTER_FLAG_PATH_REQUIRED</constant> pour filter une
<acronym>URL</acronym>, il faut indiquer le chemin utilisé
(tel que <literal>http://example.org/foo</literal>).
</para> </preface>
&reference.filter.setup;
&reference.filter.filters;
&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
-->