Update filter

reference/curl/constants_curl_setopt.xml

@@ -3697,9 +3697,7 @@
    </term>
    <listitem>
     <para>
-     Sets the maximum number of TCP keep-alive probes.
-     The default is <literal>9</literal>.
-     Available as of PHP 8.4.0 and cURL 8.9.0.
+     设置 TCP 保持活动探测的最大数量。默认值为 <literal>9</literal>。自 PHP 8.4.0 和 cURL 8.9.0 起可用。
     </para>
    </listitem>
   </varlistentry>
@@ -3721,11 +3719,9 @@
    </term>
    <listitem>
     <para>
-     Set an <type>array</type> of <type>string</type>s to pass to the telnet negotiations.
-     The variables should be in the format <literal>&gt;option=value&lt;</literal>.
-     cURL supports the options <literal>TTYPE</literal>,
-     <literal>XDISPLOC</literal> and <literal>NEW_ENV</literal>.
-     Available as of cURL 7.7.0.
+     设置要传递给 telnet 协商的由 <type>string</type> 组成的 <type>array</type>。变量应采用
+     <literal>&gt;option=value&lt;</literal> 格式。cURL 支持选项 <literal>TTYPE</literal>、<literal>XDISPLOC</literal>
+     和 <literal>NEW_ENV</literal>。自 cURL 7.7.0 起可用。
     </para>
    </listitem>
   </varlistentry>
@@ -3736,14 +3732,10 @@
    </term>
    <listitem>
     <para>
-     Set the blocksize to use for TFTP data transmission.
-     Valid range is <literal>8</literal>-<literal>65464</literal> bytes.
-     The default of <literal>512</literal> bytes is used if this option is not specified.
-     The specified block size is only used if supported by the remote server.
-     If the server does not return an option acknowledgment
-     or returns an option acknowledgment with no block size,
-     the default of <literal>512</literal> bytes is used.
-     Available as of cURL 7.19.4.
+     设置用于 TFTP 数据传输的块大小。有效范围为 <literal>8</literal>-<literal>65464</literal>
+     字节。如果未指定此选项，则使用默认值 <literal>512</literal>
+     字节。仅当远程服务器支持时才使用指定的块大小。如果服务器未返回选项确认或返回没有块大小的选项确认，则使用默认值
+     <literal>512</literal> 字节。自 cURL 7.19.4 起可用。
     </para>
    </listitem>
   </varlistentry>
@@ -3781,9 +3773,8 @@
    </term>
    <listitem>
     <para>
-     允许 cURL 函数执行的最长秒数。
-     Defaults to <literal>0</literal>, meaning that functions never time out during transfer.
-     Available as of cURL 7.1.0.
+     允许 cURL 函数执行的最长秒数。默认值为
+     <literal>0</literal>，表示函数在传输过程中永不超时。自 cURL 7.1.0 起可用。
     </para>
    </listitem>
   </varlistentry>
@@ -3794,10 +3785,9 @@
    </term>
    <listitem>
     <para>
-     允许 cURL 允许执行的最长毫秒数。如果 cURL 编译时使用系统标准的名称解析器（ standard system name
-     resolver），那部分的连接仍旧使用以秒计的超时解决方案，最小超时时间还是一秒钟。
-     Defaults to <literal>0</literal>, meaning that functions never time out during transfer.
-     Available as of cURL 7.16.2.
+     允许 cURL 允许执行的最长毫秒数。如果 cURL 编译时使用系统标准的名称解析器（standard system name
+     resolver），那部分的连接仍旧使用以秒计的超时解决方案，最小超时时间还是一秒钟。默认值为
+     <literal>0</literal>，表示函数在传输过程中永不超时。自 cURL 7.16.2 起可用。
     </para>
    </listitem>
   </varlistentry>

reference/filter/book.xml

@@ -1,41 +1,40 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: dff279a1fb1cefe17b594d2058741b308e420a36 Maintainer: mowangjuanzi Status: ready -->
+<!-- EN-Revision: 53054bf8decc8648cf2e90a493692a161e2371af Maintainer: mowangjuanzi 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;
-  <para>
-   该扩展通过验证或清理数据来过滤数据。当数据源包含像用户提供的输入数据等未知（或外部）数据时，这尤其有用。例如，这些数据可能来自 HTML 表单。
-  </para>
-  <para>
+  <simpara>
+   该扩展提供过滤器，用于验证或清理数据。当数据源包含像用户提供的输入数据等未知（或外部）数据时，这尤其有用。例如，这些数据可能来自 <acronym>HTML</acronym> 表单。
+  </simpara>
+  <simpara>
    有两种主要的过滤类型：<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>flag</emphasis>是可选的，可以根据需要调整行为。例如，在过滤 <acronym>URL</acronym> 时传递
-   <constant>FILTER_FLAG_PATH_REQUIRED</constant> 将要求存在路径（如 <literal>http://example.org/foo</literal> 中的 <literal>/foo</literal>）。
-  </para>
+  </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>flag</emphasis>，这些 flag 可以调整过滤器的行为。这些标记通过 <constant>FILTER_FLAG_<replaceable>*</replaceable></constant>
+   常量区分。例如，将 <constant>FILTER_FLAG_PATH_REQUIRED</constant> 与 <constant>FILTER_VALIDATE_URL</constant> 验证过滤器一起使用，可以要求 URL
+   存在路径（例如 <literal>https://example.org/foo</literal> 中的 <literal>/foo</literal>）。
+  </simpara>
  </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