filters.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 372e1b4d392a909073c06aba5975d7bedbf0b725 Maintainer: takagi Status: ready -->
<!-- CREDITS: mumumu -->
<chapter xml:id="filter.filters" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>フィルタの型</title>

 <!--Validate filters: {{{-->
 <section xml:id="filter.filters.validate">
  <title>検証フィルタ</title>
   <para>
    <table>
     <title>検証用のフィルタの一覧</title>
     <tgroup cols="5">
      <thead>
       <row>
        <entry>ID</entry>
        <entry>名前</entry>
        <entry>オプション</entry>
        <entry>フラグ</entry>
        <entry>説明</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry>
         <constant>FILTER_VALIDATE_BOOLEAN</constant>,
         <constant>FILTER_VALIDATE_BOOL</constant>
        </entry>
        <entry>"boolean"</entry>
        <entry>
         <parameter>default</parameter>
        </entry>
        <entry>
          <constant>FILTER_NULL_ON_FAILURE</constant>
        </entry>
        <entry>
         <para>
          "1"、"true"、"on" および "yes" の場合に &true;、
          それ以外の場合に &false; を返します。
         </para>
         <para>
          <constant>FILTER_NULL_ON_FAILURE</constant> が設定されている場合は、
          &false; が返されるのは
          "0"、"false"、"off"、"no" および "" の場合のみとなります。
          boolean 以外の値については &null; を返します。
         </para>
         <para>
          文字列の値については、
          比較する前に先頭および末尾にあるホワイトスペースが取り除かれます。
          取り除くために、<function>trim</function> 関数を使います。
         </para>
        </entry>
       </row>
       <row>
        <entry><constant>FILTER_VALIDATE_DOMAIN</constant></entry>
        <entry>"validate_domain"</entry>
        <entry>
         <parameter>default</parameter>
        </entry>
        <entry>
         <constant>FILTER_FLAG_HOSTNAME</constant>,
         <constant>FILTER_NULL_ON_FAILURE</constant>
        </entry>
        <entry>
         <para>
          ドメイン名ラベルの長さが妥当であるかを検証します。
         </para>
         <para>
          ドメイン名が
          RFC 1034, RFC 1035, RFC 952,
          RFC 1123, RFC 2732, RFC 2181, RFC 1123
          に照らして正しいかを検証します。
          オプションのフラグ
          <constant>FILTER_FLAG_HOSTNAME</constant> を使うと、
          ホスト名 (アルファベットか数字で始まり、
          アルファベットか数字、もしくはハイフンのみが
          含まれている必要があります) も追加で検証できます。
         </para>
        </entry>
       </row>
       <row>
        <entry><constant>FILTER_VALIDATE_EMAIL</constant></entry>
        <entry>"validate_email"</entry>
        <entry>
         <parameter>default</parameter>
        </entry>
        <entry>
         <constant>FILTER_FLAG_EMAIL_UNICODE</constant>,
         <constant>FILTER_NULL_ON_FAILURE</constant>
        </entry>
        <entry>
         <para>
          値が妥当な e-mail アドレスであるかどうかを検証します。
         </para>
         <para>
          この検証は、e-mail アドレスが
          <link xlink:href="&url.rfc;822">RFC 822</link>
          の <literal>addr-spec</literal>
          形式 に沿ったものであるかどうかを確かめます。
          ただし、コメント、空白の折り返し (whitespace folding) および
          ドットなしドメイン名 (dotless domain name) には対応していません。
         </para>
        </entry>
       </row>
       <row>
        <entry><constant>FILTER_VALIDATE_FLOAT</constant></entry>
        <entry>"float"</entry>
        <entry>
         <parameter>default</parameter>,
         <parameter>decimal</parameter>,
         <parameter>min_range</parameter>,
         <parameter>max_range</parameter>
        </entry>
        <entry>
         <constant>FILTER_FLAG_ALLOW_THOUSAND</constant>,
         <constant>FILTER_NULL_ON_FAILURE</constant>
        </entry>
        <entry>
         <para>
          値が float であるかどうかを検証し、オプションで指定された範囲にあるかを調べます。成功した場合は値を float に変換します。
         </para>
         <para>
          文字列の値については、
          比較する前に先頭および末尾にあるホワイトスペースが取り除かれます。
          取り除くために、<function>trim</function> 関数を使います。
         </para>
        </entry>
       </row>
       <row>
        <entry><constant>FILTER_VALIDATE_INT</constant></entry>
        <entry>"int"</entry>
        <entry>
         <parameter>default</parameter>,
         <parameter>min_range</parameter>,
         <parameter>max_range</parameter>
        </entry>
        <entry>
         <constant>FILTER_FLAG_ALLOW_OCTAL</constant>,
         <constant>FILTER_FLAG_ALLOW_HEX</constant>,
         <constant>FILTER_NULL_ON_FAILURE</constant>
        </entry>
        <entry>
         <para>
          値が整数であるかどうか、オプションで指定した範囲内にあるかどうかを検証し、成功した場合は整数に変換します。
         </para>
         <para>
          文字列の値については、
          比較する前に先頭および末尾にあるホワイトスペースが取り除かれます。
          取り除くために、<function>trim</function> 関数を使います。
         </para>
        </entry>
       </row>
       <row>
        <entry><constant>FILTER_VALIDATE_IP</constant></entry>
        <entry>"validate_ip"</entry>
        <entry>
         <parameter>default</parameter>
        </entry>
        <entry>
         <constant>FILTER_FLAG_IPV4</constant>,
         <constant>FILTER_FLAG_IPV6</constant>,
         <constant>FILTER_FLAG_NO_PRIV_RANGE</constant>,
         <constant>FILTER_FLAG_NO_RES_RANGE</constant>,
         <constant>FILTER_FLAG_GLOBAL_RANGE</constant>,
         <constant>FILTER_NULL_ON_FAILURE</constant>
        </entry>
        <entry>
         値が IP アドレスであるかどうかを検証します。
         オプションで IPv4 あるいは IPv6 のみの指定、
         プライベートアドレスや予約済みアドレスではないことの指定もできます。
        </entry>
       </row>
       <row>
        <entry><constant>FILTER_VALIDATE_MAC</constant></entry>
        <entry>"validate_mac_address"</entry>
        <entry>
         <parameter>default</parameter>
        </entry>
        <entry>
         <constant>FILTER_NULL_ON_FAILURE</constant>
        </entry>
        <entry>値が MAC アドレスであるかどうかを検証します。</entry>
       </row>
       <row>
        <entry><constant>FILTER_VALIDATE_REGEXP</constant></entry>
        <entry>"validate_regexp"</entry>
        <entry>
         <parameter>default</parameter>,
         <parameter>regexp</parameter>
        </entry>
        <entry>
         <constant>FILTER_NULL_ON_FAILURE</constant>
        </entry>
        <entry>
         値が、<link linkend="book.pcre">Perl 互換の</link>
         正規表現 <parameter>regexp</parameter> に一致するかどうかを検証します。
        </entry>
       </row>
       <row>
        <entry><constant>FILTER_VALIDATE_URL</constant></entry>
        <entry>"validate_url"</entry>
        <entry>
         <parameter>default</parameter>
        </entry>
        <entry>
         <constant>FILTER_FLAG_SCHEME_REQUIRED</constant>,
         <constant>FILTER_FLAG_HOST_REQUIRED</constant>,
         <constant>FILTER_FLAG_PATH_REQUIRED</constant>,
         <constant>FILTER_FLAG_QUERY_REQUIRED</constant>,
         <constant>FILTER_NULL_ON_FAILURE</constant>
        </entry>
        <entry>
         値が URL 形式である (<link xlink:href="&url.rfc;2396">&url.rfc;2396</link> に準拠している) かどうか、
         オプションで、必須コンポーネントが含まれているかどうかを検証します。
         妥当な URL が、HTTP プロトコル <literal>http://</literal> を指定しているとは限りません。
         つまり、その URL が期待通りのプロトコル
         (<literal>ssh://</literal> や <literal>mailto:</literal> など)
         を使っているかどうか、さらなる検証が必要だということです。
         この関数は、ASCII の URL のみを正しいとみなすことに注意しましょう。
         国際化ドメイン名 (非 ASCII 文字を含むもの) は失敗します。
         </entry>
       </row>
      </tbody>
     </tgroup>
    </table>
   </para>
   <note>
    <para>
     オプションに <parameter>default</parameter> を設定すると、値が検証されなかったときに <parameter>default</parameter> の値を使います。
    </para>
   </note>

  <simplesect role="changelog">
   &reftitle.changelog;
   <para>
    <informaltable>
     <tgroup cols="2">
      <thead>
       <row>
        <entry>&Version;</entry>
        <entry>&Description;</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry>8.0.0</entry>
        <entry>
         <constant>FILTER_FLAG_SCHEME_REQUIRED</constant> および、
         <constant>FILTER_VALIDATE_URL</constant> フィルタのための
         <constant>FILTER_FLAG_HOST_REQUIRED</constant> フラグは削除されました。
         <literal>scheme</literal> と <literal>host</literal>
         は (かつてもそうでしたが) 常に必須になっています。
        </entry>
       </row>
       <row>
        <entry>8.0.0</entry>
        <entry>
         <constant>FILTER_VALIDATE_BOOLEAN</constant> のエイリアスとして
         <constant>FILTER_VALIDATE_BOOL</constant> が追加されました。
         <constant>FILTER_VALIDATE_BOOL</constant> を使う方が好ましいです。
        </entry>
       </row>
       <row>
        <entry>7.4.0</entry>
        <entry>
         <constant>FILTER_VALIDATE_FLOAT</constant> 向けに
         <parameter>min_range</parameter> と <parameter>max_range</parameter>
         オプションが追加されました。
        </entry>
       </row>
       <row>
        <entry>7.0.0</entry>
        <entry>
         <constant>FILTER_FLAG_HOSTNAME</constant>
         と
         <constant>FILTER_VALIDATE_DOMAIN</constant>
         が追加されました。
        </entry>
       </row>
      </tbody>
     </tgroup>
    </informaltable>
   </para>
  </simplesect>

 </section>
 <!--}}}-->

 <!-- Sanitize filters: {{{-->
 <section xml:id="filter.filters.sanitize">
  <title>除去フィルタ</title>
   <para>
    <table>
     <title>除去フィルタの一覧</title>
     <tgroup cols="5">
      <thead>
       <row>
        <entry>ID</entry>
        <entry>名前</entry>
        <entry>フラグ</entry>
        <entry>説明</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry><constant>FILTER_SANITIZE_EMAIL</constant></entry>
        <entry>"email"</entry>
        <entry></entry>
        <entry>
         英字、数字および
         <literal>!#$%&amp;'*+-=?^_`{|}~@.[]</literal>
         以外のすべての文字を取り除きます。
        </entry>
       </row>
       <row>
        <entry><constant>FILTER_SANITIZE_ENCODED</constant></entry>
        <entry>"encoded"</entry>
        <entry>
         <constant>FILTER_FLAG_STRIP_LOW</constant>,
         <constant>FILTER_FLAG_STRIP_HIGH</constant>,
         <constant>FILTER_FLAG_STRIP_BACKTICK</constant>,
         <constant>FILTER_FLAG_ENCODE_LOW</constant>,
         <constant>FILTER_FLAG_ENCODE_HIGH</constant>
        </entry>
        <entry>
         文字列を URL エンコードします。オプションで、
         特殊文字を取り除いたりエンコードしたりします。
        </entry>
       </row>
       <row>
        <entry><constant>FILTER_SANITIZE_MAGIC_QUOTES</constant></entry>
        <entry>"magic_quotes"</entry>
        <entry></entry>
        <entry>
         <function>addslashes</function> を適用します。
         (PHP 7.3.0 以降は<emphasis>非推奨</emphasis>になり、
          PHP 8.0.0 以降 <emphasis>削除</emphasis> されています。
          代わりに <constant>FILTER_SANITIZE_ADD_SLASHES</constant>
          を使ってください)
        </entry>
       </row>
       <row>
        <entry><constant>FILTER_SANITIZE_ADD_SLASHES</constant></entry>
        <entry>"add_slashes"</entry>
        <entry></entry>
        <entry><function>addslashes</function> を適用します。
        (PHP 7.3.0 以降で利用可能です)</entry>
       </row>
       <row>
        <entry><constant>FILTER_SANITIZE_NUMBER_FLOAT</constant></entry>
        <entry>"number_float"</entry>
        <entry>
         <constant>FILTER_FLAG_ALLOW_FRACTION</constant>,
         <constant>FILTER_FLAG_ALLOW_THOUSAND</constant>,
         <constant>FILTER_FLAG_ALLOW_SCIENTIFIC</constant>
        </entry>
        <entry>
         数字、<literal>+-</literal> および
         オプションで <literal>.,eE</literal>
         以外のすべての文字を取り除きます。
        </entry>
       </row>
       <row>
        <entry><constant>FILTER_SANITIZE_NUMBER_INT</constant></entry>
        <entry>"number_int"</entry>
        <entry></entry>
        <entry>
         数字、プラス記号、マイナス記号
         以外のすべての文字を取り除きます。
        </entry>
       </row>
       <row>
        <entry><constant>FILTER_SANITIZE_SPECIAL_CHARS</constant></entry>
        <entry>"special_chars"</entry>
        <entry>
         <constant>FILTER_FLAG_STRIP_LOW</constant>,
         <constant>FILTER_FLAG_STRIP_HIGH</constant>,
         <constant>FILTER_FLAG_STRIP_BACKTICK</constant>,
         <constant>FILTER_FLAG_ENCODE_HIGH</constant>
        </entry>
        <entry>
         <literal>'"&lt;&gt;&amp;</literal> および
         ASCII 値が 32 未満の文字を HTML エンコードします。オプションで、
         その他の特殊文字を取り除いたりエンコードしたりします。
        </entry>
       </row>
       <row>
        <entry><constant>FILTER_SANITIZE_FULL_SPECIAL_CHARS</constant></entry>
        <entry>"full_special_chars"</entry>
        <entry>
         <constant>FILTER_FLAG_NO_ENCODE_QUOTES</constant>
        </entry>
        <entry>
         <function>htmlspecialchars</function> に <constant>ENT_QUOTES</constant> を指定してコールするのと同じです。
         クォートのエンコードを無効にするには
         <constant>FILTER_FLAG_NO_ENCODE_QUOTES</constant> を設定します。
         <function>htmlspecialchars</function> と同様、このフィルタは
         <link linkend="ini.default-charset">default_charset</link> に対応しています。
         現在の文字セットで無効な文字となるバイトシーケンスが検出されると文字列全体を拒否し、
         結果は長さ 0 の文字列となります。
         このフィルタをデフォルトのフィルタとして使う場合は、以下の警告を参考にして
         デフォルトのフラグを 0 に設定しましょう。
        </entry>
       </row>
       <row>
        <entry><constant>FILTER_SANITIZE_STRING</constant></entry>
        <entry>"string"</entry>
        <entry>
         <constant>FILTER_FLAG_NO_ENCODE_QUOTES</constant>,
         <constant>FILTER_FLAG_STRIP_LOW</constant>,
         <constant>FILTER_FLAG_STRIP_HIGH</constant>,
         <constant>FILTER_FLAG_STRIP_BACKTICK</constant>,
         <constant>FILTER_FLAG_ENCODE_LOW</constant>,
         <constant>FILTER_FLAG_ENCODE_HIGH</constant>,
         <constant>FILTER_FLAG_ENCODE_AMP</constant>
        </entry>
        <entry>
         タグと、エンコードされたシングルクォート、
         ダブルクォートを取り除きます。
         オプションで、
         特殊文字を取り除いたりエンコードしたりします。
         クォートをエンコードする動作は、
         <constant>FILTER_FLAG_NO_ENCODE_QUOTES</constant>
         を設定することで無効に出来ます。
         (PHP 8.1.0 以降は <emphasis>非推奨</emphasis> になりました。
         代わりに <function>htmlspecialchars</function> を使って下さい)
        </entry>
       </row>
       <row>
        <entry><constant>FILTER_SANITIZE_STRIPPED</constant></entry>
        <entry>"stripped"</entry>
        <entry></entry>
        <entry>
         "string" フィルタのエイリアス。
         (PHP 8.1.0 以降は <emphasis>非推奨</emphasis> になりました。
         代わりに <function>htmlspecialchars</function> を使って下さい)
        </entry>
       </row>
       <row>
        <entry><constant>FILTER_SANITIZE_URL</constant></entry>
        <entry>"url"</entry>
        <entry></entry>
        <entry>
         英字、数字および
         <literal>$-_.+!*'(),{}|\\^~[]`&lt;&gt;#%";/?:@&amp;=</literal>
         以外のすべての文字を取り除きます。
        </entry>
       </row>
       <row>
        <entry><constant>FILTER_UNSAFE_RAW</constant></entry>
        <entry>"unsafe_raw"</entry>
        <entry>
         <constant>FILTER_FLAG_STRIP_LOW</constant>,
         <constant>FILTER_FLAG_STRIP_HIGH</constant>,
         <constant>FILTER_FLAG_STRIP_BACKTICK</constant>,
         <constant>FILTER_FLAG_ENCODE_LOW</constant>,
         <constant>FILTER_FLAG_ENCODE_HIGH</constant>,
         <constant>FILTER_FLAG_ENCODE_AMP</constant>
        </entry>
        <entry>
         何もせず、オプションで特殊文字を取り除いたりエンコードしたりします。
         <constant>FILTER_DEFAULT</constant> は、このフィルタのエイリアスです。
        </entry>
       </row>
      </tbody>
     </tgroup>
    </table>
   </para>
   <warning>
     <para>
       これらのフィルタのいずれかを ini ファイルやウェブサーバーの設定でデフォルトフィルタとして使用すると、
       デフォルトのフラグは
       <constant>FILTER_FLAG_NO_ENCODE_QUOTES</constant> となります。
       デフォルトでクォートをエンコードさせるには、
       明示的に filter.default_flags を 0 としなければなりません。
       <example>
         <title>デフォルトのフィルタを htmlspecialchars と同様の挙動にする設定</title>
         <programlisting role="php">
<![CDATA[
filter.default = full_special_chars
filter.default_flags = 0
]]>
         </programlisting>
       </example>
     </para>
   </warning>
   
  <simplesect role="changelog">
   &reftitle.changelog;
   <para>
    <informaltable>
     <tgroup cols="2">
      <thead>
       <row>
        <entry>&Version;</entry>
        <entry>&Description;</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry>8.1.0</entry>
        <entry>
         <constant>FILTER_SANITIZE_STRING</constant> と
         <constant>FILTER_SANITIZE_STRIPPED</constant> は推奨されなくなりました。
        </entry>
       </row>
       <row>
        <entry>8.0.0</entry>
        <entry>
         <constant>FILTER_SANITIZE_MAGIC_QUOTES</constant> が削除されました。
        </entry>
       </row>
       <row>
        <entry>7.3.0</entry>
        <entry>
         <constant>FILTER_SANITIZE_MAGIC_QUOTES</constant> の代替として
         <constant>FILTER_SANITIZE_ADD_SLASHES</constant> が追加されました。
        </entry>
       </row>
       <row>
        <entry>7.3.0</entry>
        <entry>
         <constant>FILTER_SANITIZE_MAGIC_QUOTES</constant> は推奨されなくなりました。
        </entry>
       </row>
      </tbody>
     </tgroup>
    </informaltable>
   </para>
  </simplesect>

 </section>
 <!--}}}-->

 <!-- Other filters: {{{-->
 <section xml:id="filter.filters.misc">
  <title>その他のフィルタ</title>
   <para>
    <table>
     <title>その他のフィルタの一覧</title>
     <tgroup cols="5">
      <thead>
       <row>
        <entry>ID</entry>
        <entry>名前</entry>
        <entry>オプション</entry>
        <entry>フラグ</entry>
        <entry>説明</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry><constant>FILTER_CALLBACK</constant></entry>
        <entry>"callback"</entry>
        <entry><type>callable</type> 関数あるいはメソッド</entry>
        <entry></entry>
        <entry>ユーザー定義の関数をコールしてデータをフィルタリングします。</entry>
       </row>
      </tbody>
     </tgroup>
    </table>
   </para>
 </section>
 <!--}}}-->

 <!-- Filter flags: {{{-->
 <section xml:id="filter.filters.flags">
  <title>フィルタフラグ</title>
  
  <para>
   <table>
    <title>フィルタフラグの一覧</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>ID</entry>
       <entry>使える場所</entry>
       <entry>説明</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><constant>FILTER_FLAG_STRIP_LOW</constant></entry>
       <entry>
        <constant>FILTER_SANITIZE_ENCODED</constant>,
        <constant>FILTER_SANITIZE_SPECIAL_CHARS</constant>,
        <constant>FILTER_SANITIZE_STRING</constant>,
        <constant>FILTER_UNSAFE_RAW</constant>
       </entry>
       <entry>
        コードが 32 未満の文字を除去します。
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_FLAG_STRIP_HIGH</constant></entry>
       <entry>
        <constant>FILTER_SANITIZE_ENCODED</constant>,
        <constant>FILTER_SANITIZE_SPECIAL_CHARS</constant>,
        <constant>FILTER_SANITIZE_STRING</constant>,
        <constant>FILTER_UNSAFE_RAW</constant>
       </entry>
       <entry>
        コードが 127 より大きい文字を除去します。
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_FLAG_STRIP_BACKTICK</constant></entry>
       <entry>
        <constant>FILTER_SANITIZE_ENCODED</constant>,
        <constant>FILTER_SANITIZE_SPECIAL_CHARS</constant>,
        <constant>FILTER_SANITIZE_STRING</constant>,
        <constant>FILTER_UNSAFE_RAW</constant>
       </entry>
       <entry>
        バッククォート文字を除去します。
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_FLAG_ALLOW_FRACTION</constant></entry>
       <entry>
        <constant>FILTER_SANITIZE_NUMBER_FLOAT</constant>
       </entry>
       <entry>
        ピリオド (<literal>.</literal>) を数値の小数点として許可します。
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_FLAG_ALLOW_THOUSAND</constant></entry>
       <entry>
        <constant>FILTER_SANITIZE_NUMBER_FLOAT</constant>,
        <constant>FILTER_VALIDATE_FLOAT</constant>
       </entry>
       <entry>
        カンマ (<literal>,</literal>) を数値の桁区切り文字として許可します。
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_FLAG_ALLOW_SCIENTIFIC</constant></entry>
       <entry>
        <constant>FILTER_SANITIZE_NUMBER_FLOAT</constant>
       </entry>
       <entry>
        <literal>e</literal> あるいは <literal>E</literal> を、
        科学記法の数値として許可します。
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_FLAG_NO_ENCODE_QUOTES</constant></entry>
       <entry>
        <constant>FILTER_SANITIZE_STRING</constant>
       </entry>
       <entry>
        このフラグを指定すると、シングルクォート (<literal>'</literal>)
        およびダブルクォート (<literal>"</literal>) をエンコードしません。
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_FLAG_ENCODE_LOW</constant></entry>
       <entry>
        <constant>FILTER_SANITIZE_ENCODED</constant>,
        <constant>FILTER_SANITIZE_STRING</constant>,
        <constant>FILTER_UNSAFE_RAW</constant>
       </entry>
       <entry>
        コードが 32 未満のすべての文字をエンコードします。
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_FLAG_ENCODE_HIGH</constant></entry>
       <entry>
        <constant>FILTER_SANITIZE_ENCODED</constant>,
        <constant>FILTER_SANITIZE_SPECIAL_CHARS</constant>,
        <constant>FILTER_SANITIZE_STRING</constant>,
        <constant>FILTER_UNSAFE_RAW</constant>
       </entry>
       <entry>
        コードが 127 より大きいすべての文字をエンコードします。
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_FLAG_ENCODE_AMP</constant></entry>
       <entry>
        <constant>FILTER_SANITIZE_STRING</constant>,
        <constant>FILTER_UNSAFE_RAW</constant>
       </entry>
       <entry>
        アンパサンド (<literal>&amp;</literal>) をエンコードします。
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_NULL_ON_FAILURE</constant></entry>
       <entry>
        <constant>FILTER_VALIDATE_BOOLEAN</constant>,
        <constant>FILTER_VALIDATE_BOOL</constant>
        任意の
        <link linkend="filter.filters.validate"><constant>FILTER_VALIDATE_*</constant></link> 定数。
       </entry>
       <entry>
        認識できない値の場合に &null; を返します。
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_FLAG_ALLOW_OCTAL</constant></entry>
       <entry>
        <constant>FILTER_VALIDATE_INT</constant>
       </entry>
       <entry>
        ゼロ (<literal>0</literal>) で始まる入力を八進数とみなします。
        ゼロの後には <literal>0-7</literal> しか続けることができません。
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_FLAG_ALLOW_HEX</constant></entry>
       <entry>
        <constant>FILTER_VALIDATE_INT</constant>
       </entry>
       <entry>
        <literal>0x</literal> あるいは
        <literal>0X</literal> で始まる入力を十六進数とみなします。
        後に続けられる文字は <literal>a-fA-F0-9</literal> だけです。
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_FLAG_EMAIL_UNICODE</constant></entry>
       <entry>
        <constant>FILTER_VALIDATE_EMAIL</constant>
       </entry>
       <entry>
        email アドレスのローカルパートに Unicode 文字を含めることを許可します。
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_FLAG_IPV4</constant></entry>
       <entry>
        <constant>FILTER_VALIDATE_IP</constant>
       </entry>
       <entry>
        IPv4 形式の IP アドレスを許可します。
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_FLAG_IPV6</constant></entry>
       <entry>
        <constant>FILTER_VALIDATE_IP</constant>
       </entry>
       <entry>
        IPv6 形式の IP アドレスを許可します。
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_FLAG_NO_PRIV_RANGE</constant></entry>
       <entry>
        <constant>FILTER_VALIDATE_IP</constant>
       </entry>
       <entry>
        <para>
         IPv4 プライベート領域
         <literal>10.0.0.0/8</literal>, <literal>172.16.0.0/12</literal> および
         <literal>192.168.0.0/16</literal>
         を許可しません。
        </para>
        <para>
         <literal>FD</literal> あるいは <literal>FC</literal>
         ではじまる IPv6 アドレスを許可しません。
        </para>
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_FLAG_NO_RES_RANGE</constant></entry>
       <entry>
        <constant>FILTER_VALIDATE_IP</constant>
       </entry>
       <entry>
        <para>
        予約済みの IPv4 範囲
        <literal>0.0.0.0/8</literal>, <literal>169.254.0.0/16</literal>,
        <literal>127.0.0.0/8</literal> および <literal>240.0.0.0/4</literal>
        を許可しません。
        </para>
        <para>
         予約済みの IPv6 範囲
         <literal>::1/128</literal>、<literal>::/128</literal>、
         <literal>::ffff:0:0/96</literal> および <literal>fe80::/10</literal>
         を許可しません。
        </para>
        <para>
         これらの IP の範囲は、
         <link xlink:href="&url.rfc;6890">RFC 6890</link> で、
         プロトコルによって予約されているとマークされているものです。
        </para>
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_FLAG_GLOBAL_RANGE</constant></entry>
       <entry>
        <constant>FILTER_VALIDATE_IP</constant>
       </entry>
       <entry>
        <para>
         <link xlink:href="&url.rfc;6890">RFC 6890</link> で
         <literal>Global</literal> 属性が <literal>False</literal>
         になっている、グローバルでない IPv4/IPv6 アドレスについては、
         検証が失敗します。
        </para>
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_FLAG_SCHEME_REQUIRED</constant></entry>
       <entry>
        <constant>FILTER_VALIDATE_URL</constant>
       </entry>
       <entry>
        <acronym>URL</acronym> がスキームを含むことを要求します。
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_FLAG_HOST_REQUIRED</constant></entry>
       <entry>
        <constant>FILTER_VALIDATE_URL</constant>
       </entry>
       <entry>
        <acronym>URL</acronym> がホストを含むことを要求します。
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_FLAG_PATH_REQUIRED</constant></entry>
       <entry>
        <constant>FILTER_VALIDATE_URL</constant>
       </entry>
       <entry>
        <acronym>URL</acronym> で、パス部分を必須とします。
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_FLAG_QUERY_REQUIRED</constant></entry>
       <entry>
        <constant>FILTER_VALIDATE_URL</constant>
       </entry>
       <entry>
        <acronym>URL</acronym> で、クエリ文字列を必須とします。
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_REQUIRE_SCALAR</constant></entry>
       <entry>
       </entry>
       <entry>
        値がスカラーであることを必須とします。
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_REQUIRE_ARRAY</constant></entry>
       <entry>
       </entry>
       <entry>
        値が配列であることを必須とします。
        指定されたフィルタは、配列の個々のスカラーの要素に適用されます。
       </entry>
      </row>
      <row>
       <entry><constant>FILTER_FORCE_ARRAY</constant></entry>
       <entry>
       </entry>
       <entry>
        値がスカラーである場合は、スカラー値をひとつだけ持つ配列として扱います。
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>

  <simplesect role="changelog">
   &reftitle.changelog;
   <para>
    <informaltable>
     <tgroup cols="2">
      <thead>
       <row>
        <entry>&Version;</entry>
        <entry>&Description;</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry>8.2.0</entry>
        <entry>
         <constant>FILTER_VALIDATE_IP</constant>
         に指定できるフラグとして、
         <constant>FILTER_FLAG_GLOBAL_RANGE</constant> が追加されました。
        </entry>
       </row>
       <row>
        <entry>7.3.0</entry>
        <entry>
         <constant>FILTER_FLAG_SCHEME_REQUIRED</constant>
         と <constant>FILTER_FLAG_HOST_REQUIRED</constant>
         を明示的に使用することは推奨されなくなりました。
        </entry>
       </row>
       <row>
        <entry>7.1.0</entry>
        <entry>
         <constant>FILTER_FLAG_EMAIL_UNICODE</constant> が追加されました。
        </entry>
       </row>
      </tbody>
     </tgroup>
    </informaltable>
   </para>
  </simplesect>
 </section>
 <!--}}}-->
</chapter>

<!-- 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=marker fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->