Update curl/filesystem/image/imagick/json/mbstring/opcache/yaf

Author: mowangjuanzi

reference/curl/constants_curl_setopt.xml

@@ -605,10 +605,8 @@
    </term>
    <listitem>
     <para>
-     Accepts a file handle <type>resource</type>
-     to the file that the transfer should be written to.
-     The default is <constant>STDOUT</constant> (the browser window).
-     Available as of cURL 7.1.0 and deprecated as of cURL 7.9.7.
+     接受文件句柄 <type>resource</type>，用于指定传输内容应写入的文件。默认值为
+     <constant>STDOUT</constant>（浏览器窗口）。自 cURL 7.1.0 起可用，并自 cURL 7.9.7 起被弃用。
     </para>
    </listitem>
   </varlistentry>
@@ -631,8 +629,7 @@
    </term>
    <listitem>
     <para>
-     Pass a <type>callable</type> that will be used for wildcard matching.
-     The signature of the callback should be:
+     传递用于通配符匹配的 <type>callable</type>。回调函数的签名应为：
      <methodsynopsis>
       <type>int</type><methodname><replaceable>callback</replaceable></methodname>
       <methodparam><type>resource</type><parameter>curlHandle</parameter></methodparam>
@@ -644,32 +641,30 @@
        <term><parameter>curlHandle</parameter></term>
        <listitem>
         <simpara>
-         The cURL handle.
+         cURL 句柄。
         </simpara>
        </listitem>
       </varlistentry>
       <varlistentry>
        <term><parameter>pattern</parameter></term>
        <listitem>
         <simpara>
-         The wildcard pattern.
+         通配符模式。
         </simpara>
        </listitem>
       </varlistentry>
       <varlistentry>
        <term><parameter>string</parameter></term>
        <listitem>
         <simpara>
-         The <type>string</type> to run the wildcard pattern matching on.
+         用于运行通配符模式匹配的 <type>string</type>。
         </simpara>
        </listitem>
       </varlistentry>
      </variablelist>
-     The callback should return
-     <constant>CURL_FNMATCHFUNC_MATCH</constant> if pattern matches the <type>string</type>,
-     <constant>CURL_FNMATCHFUNC_NOMATCH</constant> if not
-     or <constant>CURL_FNMATCHFUNC_FAIL</constant> if an error occurred.
-     Available as of cURL 7.21.0.
+     如果模式匹配 <type>string</type>，回调函数应返回 <constant>CURL_FNMATCHFUNC_MATCH</constant>；如果不匹配，返回
+     <constant>CURL_FNMATCHFUNC_NOMATCH</constant>；如果发生错误，返回
+     <constant>CURL_FNMATCHFUNC_FAIL</constant>。自 cURL 7.21.0 起可用。
     </para>
    </listitem>
   </varlistentry>
@@ -749,13 +744,10 @@
    </term>
    <listitem>
     <para>
-     A <type>string</type> which will be used to get the IP address to use for the FTP <literal>PORT</literal> instruction. The <literal>PORT</literal> instruction tells
-     the remote server to connect to our specified IP address.  The
-     <type>string</type> may be a plain IP address, a hostname,
-     a network interface name (under Unix),
-     or just a plain <literal>-</literal> to use the system's default IP address.
-     This option accepts a <type>string</type> or &null;.
-     Available as of cURL 7.1.0.
+     用于获取 FTP <literal>PORT</literal> 指令所使用的 IP 地址的 <type>string</type>。<literal>PORT</literal>
+     指令会告知远程服务器连接到指定 IP 地址。该 <type>string</type> 可以是纯 IP 地址、主机名、网络接口名称（在
+     Unix 系统下），或者仅为一个短横线 <literal>-</literal>，以使用系统的默认 IP 地址。此选项接受 <type>string</type>
+     或 &null;。自 cURL 7.1.0 起可用。
     </para>
    </listitem>
   </varlistentry>
@@ -778,12 +770,9 @@
    </term>
    <listitem>
     <para>
-     Pass a <type>string</type> that will be sent as account information over FTP
-     (using the <literal>ACCT</literal> command) after username and password has been provided
-     to the server.
-     Set to &null; to disable sending the account information.
-     Defaults to &null;.
-     Available as of cURL 7.13.0.
+     传递 <type>string</type>，将通过 FTP（使用 <literal>ACCT</literal>
+     命令）在提供用户名和密码后作为账户信息发送到服务器。设置为 &null; 可禁用发送账户信息。默认值为
+     &null;。自 cURL 7.13.0 起可用。
     </para>
    </listitem>
   </varlistentry>
@@ -794,9 +783,8 @@
    </term>
    <listitem>
     <para>
-     Pass a <type>string</type> that will be used to try to authenticate over FTP
-     if the <literal>USER/PASS</literal> negotiation fails.
-     Available as of cURL 7.15.5.
+     传递 <type>string</type>，将在 <literal>USER/PASS</literal> 协商失败时用于尝试通过
+     FTP 进行身份验证。自 cURL 7.15.5 起可用。
     </para>
    </listitem>
   </varlistentry>

reference/curl/functions/curl-escape.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: fc9a0a8b29a7a099998bdd71fe5350a10b18fe62 Maintainer: 胡搞 Status: ready -->
+<!-- EN-Revision: 98ee565bfbea26d2a9c8f8a8707f0403603f719e Maintainer: 胡搞 Status: ready -->
 <!-- CREDITS: mowangjuanzi -->
 <refentry xml:id="function.curl-escape" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -68,6 +68,7 @@
     <programlisting role="php">
 <![CDATA[
 <?php
+
 // 创建 curl 句柄
 $ch = curl_init();
 
@@ -79,10 +80,11 @@ $location = curl_escape($ch, 'Hofbräuhaus / München');
 $url = "http://example.com/add_location.php?location={$location}";
 // 结果：http://example.com/add_location.php?location=Hofbr%C3%A4uhaus%20%2F%20M%C3%BCnchen
 
-// 发送 HTTP 请求并关闭句柄
+// 设置选项并发送 HTTP 请求
 curl_setopt($ch, CURLOPT_URL, $url);
 curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 curl_exec($ch);
+
 ?>
 ]]>
     </programlisting>

reference/filesystem/functions/fopen.xml

@@ -30,11 +30,9 @@
       <term><parameter>filename</parameter></term>
       <listitem>
        <para>
-        如果 <parameter>filename</parameter>
-        是 "scheme://..." 的格式，则被当成一个
+        如果 <parameter>filename</parameter> 是 "scheme://..." 的格式，则被当成一个
         URL，PHP 将搜索协议处理器（也被称为封装协议）来处理此模式。如果该协议尚未注册封装协议，PHP
-        将发出一条消息来帮助检查脚本中潜在的问题并将
-        <parameter>filename</parameter>
+        将发出一条消息来帮助检查脚本中潜在的问题并将 <parameter>filename</parameter>
         当成一个普通的文件名继续执行下去。
        </para>
        <para>
@@ -45,17 +43,14 @@
         则会应用进一步的限制。
        </para>
        <para>
-        如果 PHP 认为 <parameter>filename</parameter>
-        指定的是一个已注册的协议，而该协议被注册为一个网络
-        URL，PHP 将检查并确认
-        <link linkend="ini.allow-url-fopen">allow_url_fopen</link>
+        如果 PHP 认为 <parameter>filename</parameter> 指定的是一个已注册的协议，而该协议被注册为一个网络
+        URL，PHP 将检查并确认 <link linkend="ini.allow-url-fopen">allow_url_fopen</link>
         已被激活。如果关闭了，PHP 将发出一个警告，而 <function>fopen</function> 的调用则失败。
        </para>
        <note>
         <para>
          所支持的协议列表见<xref linkend="wrappers"/>。某些协议（也被称为
-         <literal>wrappers</literal>）支持
-         <literal>context</literal> 和／或 &php.ini;
+         <literal>wrappers</literal>）支持 <literal>context</literal> 和／或 &php.ini;
          选项。参见相应的页面哪些选项可以被设定（例如 &php.ini; 中用于
          <literal>http</literal> wrapper 的 <literal>user_agent</literal> 值）。
         </para>
@@ -133,10 +128,9 @@ $handle = fopen("c:\\folder\\resource.txt", "r");
           <row>
            <entry><literal>'x'</literal></entry>
            <entry>
-            创建并以写入方式打开，将文件指针指向文件头。如果文件已存在，则
-            <function>fopen</function> 调用失败并返回 &false;，并生成一条
-            <constant>E_WARNING</constant> 级别的错误信息。如果文件不存在则尝试创建之。这和给
-            底层的 <literal>open(2)</literal> 系统调用指定
+            创建并以写入方式打开，将文件指针指向文件头。如果文件已存在，则 <function>fopen</function>
+            调用失败并返回 &false;，并生成一条 <constant>E_WARNING</constant>
+            级别的错误信息。如果文件不存在则尝试创建之。这和给底层的 <literal>open(2)</literal> 系统调用指定
             <literal>O_EXCL|O_CREAT</literal> 标记是等价的。
            </entry>
           </row>
@@ -180,10 +174,8 @@ $handle = fopen("c:\\folder\\resource.txt", "r");
       <note>
        <para>
         不同的操作系统家族具有不同的行结束习惯。当写入一个文本文件并想插入一个新行时，需要使用符合操作系统的行结束符号。基于
-        Unix 的系统使用 <literal>\n</literal>
-        作为行结束字符，基于 Windows 的系统使用 <literal>\r\n</literal>
-        作为行结束字符，基于 Macintosh 的系统（传统 Mac OS）使用 <literal>\r</literal>
-        作为行结束字符。
+        Unix 的系统使用 <literal>\n</literal> 作为行结束字符，基于 Windows 的系统使用 <literal>\r\n</literal>
+        作为行结束字符，基于 Macintosh 的系统（传统 Mac OS）使用 <literal>\r</literal> 作为行结束字符。
        </para>
        <para>
         如果写入文件时使用了错误的行结束符号，则其它应用程序打开这些文件时可能会表现得很怪异。
@@ -203,15 +195,13 @@ $handle = fopen("c:\\folder\\resource.txt", "r");
         <literal>'t'</literal>。在所有其它情况下使用 <literal>'b'</literal>。
        </para>
        <para>
-        在操作二进制文件时如果指定 <literal>'t'</literal>
-        标记，可能会碰到一些奇怪的问题，包括坏掉的图片文件以及关于
+        在操作二进制文件时如果指定 <literal>'t'</literal> 标记，可能会碰到一些奇怪的问题，包括坏掉的图片文件以及关于
         <literal>\r\n</literal> 字符的奇怪问题。
        </para>
       </note>
       <note>
        <para>
-        为移植性考虑，强烈建议重写那些依赖于
-        <literal>'t'</literal> 模式的代码使其使用正确的行结束符并改成
+        为移植性考虑，强烈建议重写那些依赖于 <literal>'t'</literal> 模式的代码使其使用正确的行结束符并改成
         <literal>'b'</literal> 模式。
        </para>
       </note>
@@ -285,7 +275,7 @@ $handle = fopen("c:\\folder\\resource.txt", "r");
   &reftitle.examples;
   <para>
    <example>
-    <title><function>fopen</function> 例子</title>
+    <title><function>fopen</function> 示例</title>
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -311,11 +301,9 @@ $handle = fopen("ftp://user:[email protected]/somefile.txt", "w");
   </note>
   <note>
    <para>
-    This function may also succeed when <parameter>filename</parameter> is a
-    directory. If you are unsure whether <parameter>filename</parameter> is a
-    file or a directory, you may need to use the <function>is_dir</function>
-    function before calling <function>fopen</function>.
-     </para>
+    当 <parameter>filename</parameter> 为目录时，此函数也可能成功。如果不确定 <parameter>filename</parameter>
+    是文件还是目录，则在调用 <function>fopen</function> 之前可能需要使用 <function>is_dir</function> 函数进行判断。
+   </para>
   </note>
  </refsect1>
 

reference/filter/constants.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: edb34f53e1d711a5bd968d1fe1b9b41e58ed38cb Maintainer: daijie Status: ready -->
+<!-- EN-Revision: 9b09581bfdd1fa1c33daa740ad49599cf665cff4 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" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -259,15 +259,15 @@
    </term>
    <listitem>
     <simpara>
-     对于 <literal>"1"</literal>、<literal>"true"</literal>、<literal>"on"</literal>
+     对于 <literal>"1"</literal>、<literal>1</literal>（包括二进制、八进制和十六进制表示法）、<literal>1.0</literal>、<literal>"true"</literal>、<literal>true</literal>、<literal>"on"</literal>
      和 <literal>"yes"</literal> 返回 &true;。
     </simpara>
     <simpara>
-     对于 <literal>"0"</literal>、<literal>"false"</literal>、<literal>"off"</literal>、<literal>"no"</literal>
+     对于 <literal>"0"</literal>、<literal>0</literal>（包括二进制、八进制和十六进制表示法）、<literal>0.0</literal>、<literal>"false"</literal>、<literal>false</literal>、<literal>"off"</literal>、<literal>"no"</literal>
      和 <literal>""</literal> 返回 &false;。
     </simpara>
     <simpara>
-     非 bool 值的返回值取决于 <constant>FILTER_NULL_ON_FAILURE</constant>。如果设置，则返回 &null;，否则返回 &false;。
+     字符串值的比较不区分大小写。非 bool 值的返回值取决于 <constant>FILTER_NULL_ON_FAILURE</constant>。如果设置，则返回 &null;，否则返回 &false;。
     </simpara>
     <variablelist xml:id="filter.constants.validation.bool.options">
      <title>可用选项</title>
@@ -476,7 +476,7 @@
    </term>
    <listitem>
     <simpara>
-     根据 <link xlink:href="&url.rfc;2396">RFC 2396</link> 验证 <acronym>URL</acronym> 名称是否有效。
+     根据 <link xlink:href="&url.rfc;2396">RFC 2396</link> 验证 <acronym>URL</acronym> 是否有效。
     </simpara>
     <variablelist xml:id="filter.constants.validation.url.options">
      <title>可用选项</title>
@@ -896,7 +896,9 @@
       <member><literal>&gt;</literal></member>
       <member><literal>&amp;</literal></member>
      </simplelist>
-     和 ASCII 值小于 32 的字符进行 HTML 编码。
+     和 ASCII 值小于 32 的字符进行 HTML 编码。与 <constant>FILTER_SANITIZE_FULL_SPECIAL_CHARS</constant>
+     过滤器不同，<constant>FILTER_SANITIZE_SPECIAL_CHARS</constant> 过滤器会忽略
+     <constant>FILTER_FLAG_NO_ENCODE_QUOTES</constant> flag。
     </para>
     <simpara>
      如果与 <constant>FILTER_FLAG_STRIP_<replaceable>*</replaceable></constant> 过滤器清理

reference/image/functions/getimagesize.xml

@@ -34,8 +34,7 @@
   <note>
    <simpara>
     注意 JPC 和 JP2 是具有不同位深度的组件。此外，JP2 文件可能包含有<literal>多个 JPEG 2000
-    代码流</literal>，此情况下，<function>getimagesize</function>
-    返回此文件顶层中碰到的第一个代码流的值。
+    代码流</literal>，此情况下，<function>getimagesize</function> 返回此文件顶层中碰到的第一个代码流的值。
    </simpara>
   </note>
   <note>
@@ -66,12 +65,10 @@
      <term><parameter>image_info</parameter></term>
      <listitem>
       <para>
-       可选参数允许从图像文件中提取一些扩展信息。目前会将不同的 <acronym>JPG</acronym> APP
-       标记作为关联数组返回。一些程序使用这些 APP 标记在图像中嵌入文本信息。
-       A very common one is to embed 
-       <link xlink:href="&url.iptc;">IPTC</link> information in the APP13 marker.
-       You can use the <function>iptcparse</function> function to parse the
-       binary APP13 marker into something readable.
+       此可选参数允许从图像文件中提取一些扩展信息。目前会将不同的 <acronym>JPG</acronym> APP
+       标记作为关联数组返回。一些程序使用这些 APP 标记在图像中嵌入文本信息。一个非常常见的用途是将
+       <link xlink:href="&url.iptc;">IPTC</link> 信息嵌入到 APP13 标记中。可以使用
+       <function>iptcparse</function> 函数将二进制的 APP13 标记解析为可读的内容。
       </para>
       <note>
        <para>
@@ -100,22 +97,18 @@
   </note>
   <note>
    <simpara>
-    <function>getimagesize</function> 是独立于任何图像元数据的。
-    例如，如果 Exif <literal>Orientation</literal> 标志设置为将图像旋转 90 或 270 度的值，
-    索引 0 和 1 被交换，即包含高度和宽度。
+    <function>getimagesize</function> 是独立于任何图像元数据的。例如，如果 Exif <literal>Orientation</literal>
+    标志设置为将图像旋转 90 或 270 度的值，索引 0 和 1 被交换，即包含高度和宽度。
    </simpara>
   </note>
   <para>
    索引 2 是表示图像类型的某个 <constant>IMAGETYPE_<replaceable>*</replaceable></constant> 常量。
   </para>
   <para>
-   Index 3 is a text string with the correct 
-   <literal>height="yyy" width="xxx"</literal> string that can be used
-   directly in an <acronym>IMG</acronym> tag.
+   索引 3 是文本字符串，包含可以直接用于 <acronym>IMG</acronym> 标签的正确 <literal>height="yyy" width="xxx"</literal> 字符串。
   </para>
   <para>
-   <literal>mime</literal> 是图像对应的 MIME 类型。此信息可用于传递具有正确 HTTP 
-   <literal>Content-type</literal> 报头的图像：
+   <literal>mime</literal> 是图像对应的 MIME 类型。此信息可用于传递具有正确 HTTP <literal>Content-type</literal> 报头的图像：
    <example>
     <title><function>getimagesize</function> 和 MIME 类型</title>
     <programlisting role="php">
@@ -142,10 +135,8 @@ if ($size && $fp) {
    <literal>bits</literal> 是每种颜色的位数。
   </para>
   <para>
-   对应一些图像类型，<literal>channels</literal> 和 <literal>bits</literal> 值的存在可能会让人困惑。
-   As an example, <acronym>GIF</acronym> always uses 3 channels
-   per pixel, but the number of bits per pixel cannot be calculated for an
-   animated <acronym>GIF</acronym> with a global color table.
+   对应一些图像类型，<literal>channels</literal> 和 <literal>bits</literal> 的存在可能会让人困惑。例如，<acronym>GIF</acronym>
+   每个像素始终使用 3 个通道，但对于带有全局彩色表的动画 <acronym>GIF</acronym>，却无法计算每个像素的位数。
   </para>
   <para>
    失败时返回 &false;。

reference/image/functions/imagedestroy.xml

@@ -1,15 +1,19 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: de13997491811ade18c2d23e9959ef2825154add Maintainer: dallas Status: ready -->
+<!-- EN-Revision: ce98b568f85353c4bf263133f09c4db9294833f9 Maintainer: dallas Status: ready -->
 <!-- CREDITS: mowangjuanzi -->
 <refentry xml:id="function.imagedestroy" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>imagedestroy</refname>
   <refpurpose>销毁图像</refpurpose>
  </refnamediv>
+ <refsynopsisdiv>
+  &warn.deprecated.function-8-5-0;
+ </refsynopsisdiv>
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
+   <modifier role="attribute">#[\Deprecated]</modifier>
    <type>bool</type><methodname>imagedestroy</methodname>
    <methodparam><type>GdImage</type><parameter>image</parameter></methodparam>
   </methodsynopsis>