mirror of
https://github.com/php/doc-ja.git
synced 2026-03-26 16:12:17 +01:00
2533691560
git-svn-id: https://svn.php.net/repository/phpdoc/ja/trunk@346859 c90b9560-bf6c-de11-be94-00142212c4b1
74 lines
2.8 KiB
XML
74 lines
2.8 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- $Revision$ -->
|
|
<!-- EN-Revision: dff279a1fb1cefe17b594d2058741b308e420a36 Maintainer: takagi Status: ready -->
|
|
|
|
<book xml:id="book.filter" xmlns="http://docbook.org/ns/docbook">
|
|
<?phpdoc extension-membership="bundled" ?>
|
|
<title>データのフィルタリング</title>
|
|
<titleabbrev>Filter</titleabbrev>
|
|
|
|
<preface xml:id="intro.filter">
|
|
&reftitle.intro;
|
|
<para>
|
|
この拡張モジュールは、データの検証や除去を行います。
|
|
未知の (外部からの) データ、たとえばユーザーの入力などを扱う際に便利です。
|
|
HTML フォームから送られてくるデータなどがこれにあたります。
|
|
</para>
|
|
<para>
|
|
フィルタリングの方式には、大きく分けて
|
|
<emphasis>検証 (validation)</emphasis> と <emphasis>除去 (sanitization)</emphasis>
|
|
のふたつがあります。
|
|
</para>
|
|
<para>
|
|
<link linkend="filter.filters.validate">検証</link> は、
|
|
データが何らかの条件を満たしているかどうかをチェックします。
|
|
たとえば <constant>FILTER_VALIDATE_EMAIL</constant> を渡すと、
|
|
データがメールアドレスとして正しい形式かどうかを調べます。
|
|
データ自体には何も手を加えません。
|
|
</para>
|
|
<para>
|
|
<link linkend="filter.filters.sanitize">除去</link> は、
|
|
望まれていない文字を除去するなどしてデータを変更します。
|
|
たとえば <constant>FILTER_SANITIZE_EMAIL</constant> を渡すと、
|
|
メールアドレスとして無効な文字が含まれている場合にそれを除去します。
|
|
つまり、データの検証を行うわけではありません。
|
|
</para>
|
|
<para>
|
|
検証および除去のいずれについても、必要に応じて <emphasis>フラグ</emphasis>
|
|
を使用して挙動を変更することができます。たとえば <acronym>URL</acronym>
|
|
のフィルタリング時に <constant>FILTER_FLAG_PATH_REQUIRED</constant>
|
|
を渡すと、パス (<literal>http://example.org/foo</literal> における
|
|
<literal>/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
|
|
-->
|
|
|