Update language/curl/filesystem/mbstring

Author: mowangjuanzi

language/predefined/variables/get.xml

@@ -1,18 +1,17 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: a6d209f4ff71ccba3f1255902827f5df3e092ff9 Maintainer: daijie Status: ready -->
-
+<!-- EN-Revision: f56de7ebe7a1a85ce9e44a2bf6b77b07adfe3ae4 Maintainer: daijie Status: ready -->
+<!-- CREDITS: mowangjuanzi -->
 <refentry role="variable" xml:id="reserved.variables.get" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false">
  <refnamediv>
   <refname>$_GET</refname>
-  <refpurpose>HTTP GET 变量</refpurpose>
+  <refpurpose>查询字符串变量</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
   &reftitle.description;
   <para>
-  通过 URL 参数（又叫 query string）传递给当前脚本的变量的数组。
-   注意：该数组不仅仅对 method 为 GET 的请求生效，而是会针对所有带 query string 的请求。
+   通过 URL 参数（也称为查询字符串）传递给当前脚本的变量（关联数组）。需要注意的是，只要存在查询字符串，就会填充此数组，无论 HTTP 请求方法为何。
   </para>
  </refsect1>
 
@@ -29,7 +28,7 @@ echo 'Hello ' . htmlspecialchars($_GET["name"]) . '!';
 ]]>
     </programlisting>
     <simpara>
-     假设用户访问的是 http://example.com/?name=Hannes
+     假设用户访问的是 <literal>http://example.com/?name=Hannes</literal>。
     </simpara>
     &example.outputs.similar;
     <screen>
@@ -46,7 +45,7 @@ Hello Hannes!
   &note.is-superglobal;
   <note>
    <para>
-    GET 是通过 <function>urldecode</function> 传递的。
+    <varname>$_GET</varname> 中的值会自动通过 <function>urldecode</function> 解码。
    </para>
   </note>
  </refsect1>

language/predefined/variables/httpresponseheader.xml

@@ -1,13 +1,20 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 3f1cd5121f7c9f8347ca69c8f657fdb24c0f9729 Maintainer: daijie Status: ready -->
+<!-- EN-Revision: fcf847c112e36140d1fdf30cc6fc83cb1c4eb297 Maintainer: daijie Status: ready -->
 <!-- CREDITS: mowangjuanzi -->
 <refentry role="variable" xml:id="reserved.variables.httpresponseheader" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false">
  <refnamediv>
   <refname>$http_response_header</refname>
   <refpurpose>HTTP 响应头</refpurpose>
  </refnamediv>
 
+ <refsynopsisdiv>
+  &warn.deprecated.feature-8-5-0;
+  <simpara>
+   使用 <function>http_get_last_response_headers</function> 代替。
+  </simpara>
+ </refsynopsisdiv>
+
  <refsect1 role="description">
   &reftitle.description;
   <para>

language/types/type-juggling.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 3a97501ec4b56ed700facd0163d11faadc58663d Maintainer: Avenger Status: ready -->
+<!-- EN-Revision: 87fd768a70bb136ad6ba94699e8c6332e0c115e0 Maintainer: Avenger Status: ready -->
 <!-- CREDITS: Geogory, dallas, Altair, mowangjuanzi, Luffy -->
 <sect1 xml:id="language.types.type-juggling">
  <title>类型转换</title>
@@ -211,7 +211,7 @@
 
    <example>
     <title>类型转换为 union 类型中的一个的示例</title>
-    <programlisting>
+    <programlisting role="php">
 <![CDATA[
 <?php
 // int|string

reference/curl/constants_curl_setopt.xml

@@ -1,4 +1,4 @@
-<!-- EN-Revision: 6d21eef094840a7277af4735b8898f70ef9cd9ba Maintainer: mowangjuanzi Status: partial -->
+<!-- EN-Revision: c9888ac6e5c75d00d50f9c2fd741ae3a82a479ec Maintainer: mowangjuanzi Status: partial -->
 <!-- CREDITS: Luffy -->
  <variablelist role="constant_list">
   <title><function>curl_setopt</function></title>
@@ -1381,13 +1381,8 @@
    </term>
    <listitem>
     <para>
-     Set a <type>string</type> with the authentication address (identity)
-     of a submitted message that is being relayed to another server.
-     The address should not be specified within a pair of angled brackets
-     (<literal>&gt;&lt;</literal>).
-     If an empty <type>string</type> is used then a pair of brackets are sent by cURL
-     as required by RFC 2554.
-     Available as of cURL 7.25.0.
+     设置 <type>string</type>，表示正在转发到另一服务器的提交消息的身份验证地址（身份）。该地址不应包含在尖括号（<literal>&lt;&gt;</literal>）中。如果使用空
+     <type>string</type>，则 cURL 会根据 RFC 2554 的要求发送一对括号。自 cURL 7.25.0 起可用。
     </para>
    </listitem>
   </varlistentry>
@@ -1398,13 +1393,9 @@
    </term>
    <listitem>
     <para>
-     Set a <type>string</type> with the sender's email address when sending SMTP mail.
-     The email address should be specified with angled brackets
-     (<literal>&gt;&lt;</literal>) around it,
-     which if not specified are added automatically.
-     If this parameter is not specified then an empty address is sent
-     to the SMTP server which might cause the email to be rejected.
-     Available as of cURL 7.20.0.
+     在发送 SMTP 邮件时，设置一个包含发件人电子邮件地址的
+     <type>string</type>。电子邮件地址应使用尖括号（<literal>&lt;&gt;</literal>）括起来，如果未指定，系统会自动添加。如果未设置此参数，则会向
+     SMTP 服务器发送空地址，这可能导致邮件被拒绝。自 cURL 7.20.0 起可用。
     </para>
    </listitem>
   </varlistentry>
@@ -1415,14 +1406,9 @@
    </term>
    <listitem>
     <para>
-     Set to an <type>array</type> of <type>string</type>s
-     with the recipients to pass to the server in an SMTP mail request.
-     Each recipient should be specified within a pair of angled brackets
-     (<literal>&gt;&lt;</literal>).
-     If an angled bracket is not used as the first character,
-     cURL assumes a single email address has been provided
-     and encloses that address within brackets.
-     Available as of cURL 7.20.0.
+     设置为由 <type>string</type> 组成的 <type>array</type>，包含在 SMTP
+     邮件请求中传递给服务器的收件人。每个收件人应使用尖括号（<literal>&lt;&gt;</literal>）括起来。如果第一个字符未使用尖括号，cURL
+     会假定提供的是单个电子邮件地址，并将该地址用括号括起来。自 cURL 7.20.0 起可用。
     </para>
    </listitem>
   </varlistentry>
@@ -3578,7 +3564,7 @@
    <listitem>
     <para>
      设置要传递给 telnet 协商的由 <type>string</type> 组成的 <type>array</type>。变量应采用
-     <literal>&gt;option=value&lt;</literal> 格式。cURL 支持选项 <literal>TTYPE</literal>、<literal>XDISPLOC</literal>
+     <literal>&lt;option=value&gt;</literal> 格式。cURL 支持选项 <literal>TTYPE</literal>、<literal>XDISPLOC</literal>
      和 <literal>NEW_ENV</literal>。自 cURL 7.7.0 起可用。
     </para>
    </listitem>

reference/filesystem/functions/parse-ini-file.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: a5346daf2bb2fab250fa03f0f6639a408d0b2240 Maintainer: HonestQiao Status: ready -->
+<!-- EN-Revision: bb54309eff8a7d75ead0fdf48cc6dae99dd00367 Maintainer: HonestQiao Status: ready -->
 <!-- CREDITS: mowangjuanzi, Luffy -->
 <refentry xml:id="function.parse-ini-file" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -24,6 +24,12 @@
   <para>
    ini 文件的结构和 &php.ini; 的相同。
   </para>
+  <warning>
+   <simpara>
+    此函数不得用于不可信的输入，除非 <parameter>scanner_mode</parameter> 设置为
+    <constant>INI_SCANNER_RAW</constant>，因为解析后的输出可能包含敏感常量的值，例如存储数据库密码的常量。
+   </simpara>
+  </warning>
  </refsect1>
 
  <refsect1 role="parameters">

reference/filesystem/functions/parse-ini-string.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: WeijianZhang Status: ready -->
+<!-- EN-Revision: bb54309eff8a7d75ead0fdf48cc6dae99dd00367 Maintainer: WeijianZhang Status: ready -->
 <!-- CREDITS: mowangjuanzi -->
 <refentry xml:id="function.parse-ini-string" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -22,6 +22,12 @@
   <para>
    ini 字符串的格式参考 &php.ini;
   </para>
+  <warning>
+   <simpara>
+    此函数不得用于不可信的输入，除非 <parameter>scanner_mode</parameter> 设置为
+    <constant>INI_SCANNER_RAW</constant>，因为解析后的输出可能包含敏感常量的值，例如存储数据库密码的常量。
+   </simpara>
+  </warning>
  </refsect1>
 
  <refsect1 role="parameters">

reference/mbstring/functions/mb-strrichr.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: f63aa0afcde35bf8450e32128295d6e08cd6b120 Maintainer: daijie Status: ready -->
+<!-- EN-Revision: 8c262f2df6f585b42b917611a029859c60539e5d Maintainer: daijie Status: ready -->
 <!-- CREDITS: mowangjuanzi -->
 <!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. -->
 <refentry xml:id="function.mb-strrichr" xmlns="http://docbook.org/ns/docbook">
@@ -31,15 +31,15 @@
      <term><parameter>haystack</parameter></term>
      <listitem>
       <para>
-       在该字符串中查找 <parameter>needle</parameter> 的最后出现位置
+       在该字符串中查找 <parameter>needle</parameter> 的最后出现位置。
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><parameter>needle</parameter></term>
      <listitem>
       <para>
-       在 <parameter>needle</parameter> 中查找该字符串
+       在 <parameter>needle</parameter> 中查找该字符串。
       </para>
      </listitem>
     </varlistentry>
@@ -56,9 +56,7 @@
     <varlistentry>
      <term><parameter>encoding</parameter></term>
      <listitem>
-      <para>
-       使用的字符编码名称。如果省略了，则将使用内部编码。
-      </para>
+      &mbstring.encoding.parameter;
      </listitem>
     </varlistentry>
    </variablelist>
@@ -67,8 +65,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   返回 <parameter>haystack</parameter> 的一部分。
-   或者在没有找到 <parameter>needle</parameter> 时返回 &false;。
+   返回 <parameter>haystack</parameter> 的一部分。或者在没有找到 <parameter>needle</parameter> 时返回 &false;。
   </para>
  </refsect1>
 

reference/mbstring/functions/mb-strripos.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 4b72b23513caa3a8bc520d459a0417defc7b3880 Maintainer: daijie Status: ready -->
+<!-- EN-Revision: 95d05546430b9e5db225dd42a0d285b870f0da42 Maintainer: daijie Status: ready -->
 <!-- CREDITS: mowangjuanzi, Luffy -->
 <!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. -->
 <refentry xml:id="function.mb-strripos" xmlns="http://docbook.org/ns/docbook">
@@ -48,16 +48,14 @@
      <term><parameter>offset</parameter></term>
      <listitem>
       <para>
-       在 <parameter>haystack</parameter> 中开始搜索的位置。
+       可以指定从 <parameter>haystack</parameter> 的任意字符位置开始搜索。负值将在 <parameter>haystack</parameter> 结尾前的某个点停止搜索。
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><parameter>encoding</parameter></term>
      <listitem>
-      <para>
-       使用的字符编码名称。如果省略了，则将使用内部编码。
-      </para>
+      &mbstring.encoding.parameter;
      </listitem>
     </varlistentry>
    </variablelist>

reference/mbstring/functions/mb-strrpos.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 4b72b23513caa3a8bc520d459a0417defc7b3880 Maintainer: daijie Status: ready -->
+<!-- EN-Revision: 95d05546430b9e5db225dd42a0d285b870f0da42 Maintainer: daijie Status: ready -->
 <!-- CREDITS: mowangjuanzi, Luffy -->
 <refentry xml:id="function.mb-strrpos" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -48,8 +48,7 @@
      <term><parameter>offset</parameter></term>
      <listitem>
       <simpara>
-       可以用于指定 <type>string</type> 里从任意字符数开始进行搜索。
-       负数的值将导致搜索会终止于指向 <type>string</type> 末尾的任意点。
+       可以指定从 <parameter>haystack</parameter> 的任意字符位置开始搜索。负值将在 <parameter>haystack</parameter> 结尾前的某个点停止搜索。
       </simpara>
      </listitem>
     </varlistentry>
@@ -99,7 +98,7 @@
      <row>
       <entry>8.0.0</entry>
       <entry>
-       已经删除将 <parameter>encoding</parameter> 作为第三个参数而不是偏移量传递。
+       已经删除将 <parameter>encoding</parameter> 作为第三个参数而不是 <parameter>offset</parameter> 传递。
       </entry>
      </row>
      &mbstring.changelog.encoding-nullable;

reference/mbstring/functions/mb-strstr.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: f63aa0afcde35bf8450e32128295d6e08cd6b120 Maintainer: daijie Status: ready -->
+<!-- EN-Revision: 95d05546430b9e5db225dd42a0d285b870f0da42 Maintainer: daijie Status: ready -->
 <!-- CREDITS: mowangjuanzi -->
 <!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. -->
 <refentry xml:id="function.mb-strstr" xmlns="http://docbook.org/ns/docbook">
@@ -55,10 +55,7 @@
     <varlistentry>
      <term><parameter>encoding</parameter></term>
      <listitem>
-      <para>
-       要使用的字符编码名称。
-       如果省略该参数，将使用内部字符编码。
-      </para>
+      &mbstring.encoding.parameter;
      </listitem>
     </varlistentry>
    </variablelist>