constants.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d83aa96e679c4e4d63390a41063469e51107c331 Maintainer: daijie Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. -->
<appendix xml:id="filter.constants" xmlns="http://docbook.org/ns/docbook">
 &reftitle.constants;
 &extension.constants;
 <variablelist>
  <varlistentry xml:id="constant.input-post">
   <term>
    <constant>INPUT_POST</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <link linkend="reserved.variables.post">POST</link> 变量。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.input-get">
   <term>
    <constant>INPUT_GET</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <link linkend="reserved.variables.get">GET</link> 变量。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.input-cookie">
   <term>
    <constant>INPUT_COOKIE</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <link linkend="reserved.variables.cookies">COOKIE</link> 变量。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.input-env">
   <term>
    <constant>INPUT_ENV</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <link linkend="reserved.variables.environment">ENV</link> 变量。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.input-server">
   <term>
    <constant>INPUT_SERVER</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <link linkend="reserved.variables.server">SERVER</link> 变量。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.input-session">
   <term>
    <constant>INPUT_SESSION</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <link linkend="reserved.variables.session">SESSION</link> 变量。
    (暂未实现)
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.input-request">
   <term>
    <constant>INPUT_REQUEST</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <link linkend="reserved.variables.request">REQUEST</link> 变量。
    (暂未实现)
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-flag-none">
   <term>
    <constant>FILTER_FLAG_NONE</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     没有标记。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-require-scalar">
   <term>
    <constant>FILTER_REQUIRE_SCALAR</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     此标记要求输入的是标量。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-require-array">
   <term>
    <constant>FILTER_REQUIRE_ARRAY</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     需要输入的是数组。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-force-array">
   <term>
    <constant>FILTER_FORCE_ARRAY</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     一律返回数组。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-null-on-failure">
   <term>
    <constant>FILTER_NULL_ON_FAILURE</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     失败时返回 NULL，而非 FALSE。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-validate-int">
   <term>
    <constant>FILTER_VALIDATE_INT</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     标记 "int" 过滤器。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-validate-bool">
   <term>
    <constant>FILTER_VALIDATE_BOOL</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <constant>FILTER_VALIDATE_BOOLEAN</constant> 的别名。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-validate-boolean">
   <term>
    <constant>FILTER_VALIDATE_BOOLEAN</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     标记 "boolean" 过滤器。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-validate-float">
   <term>
    <constant>FILTER_VALIDATE_FLOAT</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     标记 "float" 过滤器。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-validate-regexp">
   <term>
    <constant>FILTER_VALIDATE_REGEXP</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     标记 "validate_regexp" 过滤器。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-validate-url">
   <term>
    <constant>FILTER_VALIDATE_URL</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     标记 "validate_url" 过滤器。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-validate-domain">
   <term>
    <constant>FILTER_VALIDATE_DOMAIN</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     “validate_domain”过滤器的 ID。
     （自 PHP 7.0.0 起可用）
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-validate-email">
   <term>
    <constant>FILTER_VALIDATE_EMAIL</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     标记 "validate_email" 过滤器。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-validate-ip">
   <term>
    <constant>FILTER_VALIDATE_IP</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     标记 "validate_ip" 过滤器。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-validate-mac">
   <term>
    <constant>FILTER_VALIDATE_MAC</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     标记 "validate_mac_address" 过滤器。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-default">
   <term>
    <constant>FILTER_DEFAULT</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     标记默认的 "unsafe_raw" 过滤器。 等同于
    <constant>FILTER_UNSAFE_RAW</constant>。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-unsafe-raw">
   <term>
    <constant>FILTER_UNSAFE_RAW</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     标记 "unsafe_raw" 过滤器。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-sanitize-string">
   <term>
    <constant>FILTER_SANITIZE_STRING</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     标记 "string" 过滤器。
     （自 PHP 8.1.0 起弃用，使用 <function>htmlspecialchars</function> 替代。）
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-sanitize-stripped">
   <term>
    <constant>FILTER_SANITIZE_STRIPPED</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     标记 "stripped" 过滤器。
     （自 PHP 8.1.0 起弃用，使用 <function>htmlspecialchars</function> 替代。）
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-sanitize-encoded">
   <term>
    <constant>FILTER_SANITIZE_ENCODED</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     标记 "encoded" 过滤器。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-sanitize-special-chars">
   <term>
    <constant>FILTER_SANITIZE_SPECIAL_CHARS</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     标记 "special_chars" 过滤器。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-sanitize-email">
   <term>
    <constant>FILTER_SANITIZE_EMAIL</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     标记 "email" 过滤器。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-sanitize-url">
   <term>
    <constant>FILTER_SANITIZE_URL</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     标记 "url" 过滤器。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-sanitize-number-int">
   <term>
    <constant>FILTER_SANITIZE_NUMBER_INT</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     标记 "number_int" 过滤器。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-sanitize-number-float">
   <term>
    <constant>FILTER_SANITIZE_NUMBER_FLOAT</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     标记 "number_float" 过滤器。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-sanitize-magic-quotes">
   <term>
    <constant>FILTER_SANITIZE_MAGIC_QUOTES</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     标记 "magic_quotes" 过滤器。
     （自 PHP 7.3.0 起<emphasis>弃用</emphasis>，自 PHP 8.0.0
     起<emphasis>移除</emphasis>，使用 <constant>FILTER_SANITIZE_ADD_SLASHES</constant> 替代。）
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-sanitize-add-slashes">
   <term>
    <constant>FILTER_SANITIZE_ADD_SLASHES</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     “add_slashes”过滤器的 ID。
     (自 PHP 7.3.0 起可用)
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-callback">
   <term>
    <constant>FILTER_CALLBACK</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     标记 "callback" 过滤器。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-flag-allow-octal">
   <term>
    <constant>FILTER_FLAG_ALLOW_OCTAL</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     "int" 过滤器允许八进制（octal）标记的字符（<literal>0[0-7]+</literal>）。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-flag-allow-hex">
   <term>
    <constant>FILTER_FLAG_ALLOW_HEX</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     "int" 过滤器允许十六进制（Hex）标记的字符（<literal>0x[0-9a-fA-F]+</literal>）
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-flag-strip-low">
   <term>
    <constant>FILTER_FLAG_STRIP_LOW</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     过滤 ASCII 编码值大于 32 的字符 。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-flag-strip-high">
   <term>
    <constant>FILTER_FLAG_STRIP_HIGH</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     过滤 ASCII 编码值大于 127 的字符 。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-flag-strip-backtick">
   <term>
    <constant>FILTER_FLAG_STRIP_BACKTICK</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     移除反引号字符。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-flag-encode-low">
   <term>
    <constant>FILTER_FLAG_ENCODE_LOW</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     字符的 ASCII 编码值大于 32。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-flag-encode-high">
   <term>
    <constant>FILTER_FLAG_ENCODE_HIGH</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     字符的 ASCII 编码值大于 127。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-flag-encode-amp">
   <term>
    <constant>FILTER_FLAG_ENCODE_AMP</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     为 <literal>&amp;</literal> 编码。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-flag-no-encode-quotes">
   <term>
    <constant>FILTER_FLAG_NO_ENCODE_QUOTES</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     不要为 <literal>'</literal> 和 <literal>"</literal> 编码。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-flag-empty-string-null">
   <term>
    <constant>FILTER_FLAG_EMPTY_STRING_NULL</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     (目前不能使用。)
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-flag-allow-fraction">
   <term>
    <constant>FILTER_FLAG_ALLOW_FRACTION</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
      "number_float" 过滤器允许小数部分。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-flag-allow-thousand">
   <term>
    <constant>FILTER_FLAG_ALLOW_THOUSAND</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     "number_float" 过滤器允许使用千分位分隔符（<literal>,</literal>）。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-flag-allow-scientific">
   <term>
    <constant>FILTER_FLAG_ALLOW_SCIENTIFIC</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     "number_float" 过滤器允许使用科学计数法（<literal>e</literal>、<literal>E</literal>）。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-flag-path-required">
   <term>
    <constant>FILTER_FLAG_PATH_REQUIRED</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     "validate_url" 过滤器，要求带路径部分。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-flag-query-required">
   <term>
    <constant>FILTER_FLAG_QUERY_REQUIRED</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     "validate_url" 过滤器，要求带 Query 部分。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-flag-scheme-required">
   <term>
    <constant>FILTER_FLAG_SCHEME_REQUIRED</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     要求带 scheme 的“validate_url”过滤器。
     （自 PHP 7.3.0 起弃用，且自 PHP 8.0.0 起移除，因为已经隐含在过滤器中。）
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-flag-host-required">
   <term>
    <constant>FILTER_FLAG_HOST_REQUIRED</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     要求带 host 的“validate_url”过滤器。
     （自 PHP 7.3.0 起弃用，且自 PHP 8.0.0 起移除，因为已经隐含在过滤器中。）
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-flag-hostname">
   <term>
    <constant>FILTER_FLAG_HOSTNAME</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     要求主机名使用字母数字开头，并且仅包含字母数字或连字符。（自 PHP 7.0.0 起可用）。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-flag-ipv4">
   <term>
    <constant>FILTER_FLAG_IPV4</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     "validate_ip" 过滤器，仅仅允许 IPv4 地址。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-flag-ipv6">
   <term>
    <constant>FILTER_FLAG_IPV6</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     "validate_ip" 过滤器，仅仅允许 IPv6 地址。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-flag-no-res-range">
   <term>
    <constant>FILTER_FLAG_NO_RES_RANGE</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     "validate_ip" 过滤器，禁止保留 IP 地址。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-flag-no-priv-range">
   <term>
    <constant>FILTER_FLAG_NO_PRIV_RANGE</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     "validate_ip" 过滤器，禁止私有 IP 地址。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.filter-flag-email-unicode">
   <term>
    <constant>FILTER_FLAG_EMAIL_UNICODE</constant>
     (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     "validate_email" 过滤器，在邮件地址用户名部分允许 Unicode 字符。
     （PHP 7.1.0 起有效）
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>
</appendix>

<!-- 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
-->