Update chapters/features

Author: mowangjuanzi

chapters/tutorial.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 8859c8b96cd9e80652813f7bcf561432a5e9f934 Maintainer: HonestQiao Status: ready -->
+<!-- EN-Revision: 04d9aded7bbd447523cf038ddf88e6d7f7e43c53 Maintainer: HonestQiao Status: ready -->
 <!-- CREDITS: Gregory, Luffy, mowangjuanzi -->
 <chapter xml:id="tutorial" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <info><title>简明教程</title></info>
@@ -19,9 +19,9 @@
   <info><title>需要些什么？</title></info>
   <para>
    在本教程中，假设用户的服务器已经安装并运行了 PHP，所有以
-   <filename>.php</filename> 结尾的文件都将由 PHP 来处理。在大部分的服务器上，
+   <filename class="extension">.php</filename> 结尾的文件都将由 PHP 来处理。在大部分的服务器上，
    这是 PHP 的默认扩展名，不过，也请询问服务器管理员以确认。如果服务器支持 PHP
-   ，则不需要做任何事情。只用建立 <filename>.php</filename> 文件，并把它们放置
+   ，则不需要做任何事情。只用建立 <filename class="extension">.php</filename> 文件，并把它们放置
    到 web 目录中，服务器将神奇地自动解析这些文件。不用编译任何东西，也不用安装
    任何其它的工具，仅仅只需把这些使用了 PHP 的文件想象成简单的 HTML 文件，其中
    只不过多了一种新的标识符，在这里可以做各种各样的事情。

features/commandline.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: e50e79746736dbdfbabe9bd3566793b3ddf38f58 Maintainer: HonestQiao Status: ready -->
+<!-- EN-Revision: 725ceadea94af4f4db6c76b9665829f27068d2c5 Maintainer: HonestQiao Status: ready -->
 <!-- CREDITS: HonestQiao, Haohappy, Luffy, mowangjuanzi -->
 <chapter xml:id="features.commandline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>PHP 的命令行模式</title>
@@ -498,16 +498,19 @@ string(15) "doesntmakesense"
        <entry>--syntax-check</entry>
        <entry>
         <para>
-         提供了仅对指定 PHP 代码进行语法检查的便捷方法。
-         成功时将会在标准输出中写入
-         <literal>No syntax errors detected in &lt;filename&gt;</literal>
-         并且 shell 返回码为 <literal>0</literal>。失败时除了将会在标准输出中写入内部解析错误消息之外，还会写入
-         <literal>Errors parsing &lt;filename&gt;</literal>，并且 shell 返回码为 <literal>-1</literal>。
+         检查语法但不执行指定 PHP 代码。如果未指定文件，则将处理来自标准输入的输入，否则将检查每个文件。成功时，文本
+         <literal>No syntax errors detected in &lt;filename&gt;</literal> 将写入标准输出。失败时，除了内部解析器错误外，文本
+         <literal>Errors parsing &lt;filename&gt;</literal> 将写入标准输出。如果在指定文件（或标准输入）中发现任何错误，则将
+         shell 返回代码设置为 <literal>-1</literal>，否则将 shell 返回代码设置为 <literal>0</literal>。
         </para>
         <para>
-         此选项不能发现像是函数未定义之类的核心错误（fatal errors）。可以使用
-         <option>-f</option> 测试核心错误（fatal errors）。
+         此选项不会找到需要执行代码的致命错误（如未定义的函数）。
         </para>
+        <note>
+         <para>
+          在 PHP 8.3.0 之前，只能指定一个要检查的文件。
+         </para>
+        </note>
         <note>
          <para>
           此选项不能和 <option>-r</option> 一起使用。

features/file-upload.xml

@@ -1,8 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- $Author$ -->
-<!-- EN-Revision: fc174e8d6162091550edde46159917ee7e5a2e73 Maintainer: Gregory Status: ready -->
-<!-- CREDITS: dallas, Luffy -->
+<!-- EN-Revision: 04d9aded7bbd447523cf038ddf88e6d7f7e43c53 Maintainer: Gregory Status: ready -->
+<!-- CREDITS: dallas, Luffy, mowangjuanzi -->
 <chapter xml:id="features.file-upload" xmlns="http://docbook.org/ns/docbook">
  <title>文件上传处理</title>
 
@@ -456,36 +455,30 @@ Script PUT /put.php
   <simpara>
    这将告诉 Apache 将所有对 URI 的 PUT 请求全部发送到  <filename>put.php</filename> 脚本，这些
    URI 必须和 PUT 命令中的内容相匹配。当然，这是建立在 PHP 支持
-   <filename>.php</filename> 扩展名，并且 PHP 已经在运行的假设之上。
-   The destination resource for all PUT
-   requests to this script has to be the script itself, not a filename the
-   uploaded file should have.
+   <filename class="extension">.php</filename> 扩展名，并且 PHP 已经在运行的假设之上。此脚本的所有
+   PUT 请求的目标资源必须是脚本本身，而不是上传文件本身的文件名。
   </simpara>
   <simpara>
-   With PHP you would then do something like the following in
-   your put.php. This would copy the contents of the uploaded file to the
-   file <filename>myputfile.ext</filename> on the server.
-   You would probably want to perform some checks and/or
-   authenticate the user before performing this file copy.
+   使用 PHP，可以在 put.php 中执行类似下面的操作。这会将上传文件的内容复制到服务器上的文件
+   <filename>myputfile.ext</filename>。在执行此文件复制之前，可能会希望执行一些检查并且验证用户身份。
   </simpara>
   <para>
    <example>
     <title>保存 HTTP PUT 文件</title>
     <programlisting role="php">
      <![CDATA[
 <?php
-/* PUT data comes in on the stdin stream */
+/* PUT 数据来自于 stdin 流 */
 $putdata = fopen("php://input", "r");
 
-/* Open a file for writing */
+/* 打开要写入的文件 */
 $fp = fopen("myputfile.ext", "w");
 
-/* Read the data 1 KB at a time
-   and write to the file */
+/* 每次读取 1KB 的数据并写入到文件 */
 while ($data = fread($putdata, 1024))
   fwrite($fp, $data);
 
-/* Close the streams */
+/* 关闭流 */
 fclose($fp);
 fclose($putdata);
 ?>