mirror of
https://github.com/php/doc-ja.git
synced 2026-03-24 07:02:08 +01:00
83 lines
3.3 KiB
XML
83 lines
3.3 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- $Revision$ -->
|
|
<!-- EN-Revision: 53054bf8decc8648cf2e90a493692a161e2371af Maintainer: mumumu Status: ready -->
|
|
<book xml:id="book.filter" xmlns="http://docbook.org/ns/docbook">
|
|
<?phpdoc extension-membership="bundled" ?>
|
|
<title>データのフィルタリング</title>
|
|
<titleabbrev>フィルタ</titleabbrev>
|
|
|
|
<preface xml:id="intro.filter">
|
|
&reftitle.intro;
|
|
<simpara>
|
|
この拡張モジュールは、データの検証や除去を行います。
|
|
未知の (外部からの) データ、たとえばユーザーの入力などを扱う際に便利です。
|
|
<acronym>HTML</acronym> フォームから送られてくるデータなどがこれにあたります。
|
|
</simpara>
|
|
<simpara>
|
|
フィルタリングの方式には、大きく分けて
|
|
<emphasis>検証 (validation)</emphasis> と <emphasis>除去 (sanitization)</emphasis>
|
|
のふたつがあります。
|
|
</simpara>
|
|
<simpara>
|
|
検証フィルタは、
|
|
データが何らかの条件を満たしているかどうかをチェックします。
|
|
検証フィルタは、
|
|
<constant>FILTER_VALIDATE_<replaceable>*</replaceable></constant>
|
|
定数によって識別できます。
|
|
たとえば <constant>FILTER_VALIDATE_EMAIL</constant> を渡すと、
|
|
データがメールアドレスとして正しい形式かどうかを調べます。
|
|
データ自体には何も手を加えません。
|
|
</simpara>
|
|
<simpara>
|
|
一方除去フィルタは、データを"綺麗に"します。
|
|
よって、入力データに文字を追加/削除することでデータを変更します。
|
|
除去フィルタは、
|
|
<constant>FILTER_SANITIZE_<replaceable>*</replaceable></constant>
|
|
定数によって識別できます。
|
|
たとえば <constant>FILTER_SANITIZE_EMAIL</constant> を渡すと、
|
|
メールアドレスとして無効な文字が含まれている場合にそれを除去します。
|
|
しかし、除去済みのデータ自体が、
|
|
正しいメールアドレスの形式かどうかを調べるわけではありません。
|
|
</simpara>
|
|
<simpara>
|
|
ほとんどのフィルタには、
|
|
オプションの <emphasis>フラグ</emphasis> があり、
|
|
その振る舞いを細かく調整できるようになっています。
|
|
こうしたフラグは、
|
|
<constant>FILTER_FLAG_<replaceable>*</replaceable></constant>
|
|
定数によって識別できます。
|
|
たとえば、検証フィルタ <constant>FILTER_VALIDATE_URL</constant>
|
|
と一緒に <constant>FILTER_FLAG_PATH_REQUIRED</constant>
|
|
を使うと、<acronym>URL</acronym> に特定のパス
|
|
(<literal>http://example.org/foo</literal> における
|
|
<literal>/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
|
|
-->
|