Sync pcntl, install windows (#917)

php · Oct 7, 2024 · 27953aa · 27953aa
1 parent c22228b
commit 27953aa
Show file tree

Hide file tree

Showing 5 changed files with 469 additions and 29 deletions.
diff --git a/install/windows/apache2.xml b/install/windows/apache2.xml
@@ -1,9 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- $Author$ -->
-<!-- EN-Revision: d73d69f40ee1a21f1ae6eb9fe19bc6fa53995bf3 Maintainer: Luffy Status: ready -->
+<!-- EN-Revision: 2dbf3d9064d4cb07f0a2f7d06641c877a2e5ed24 Maintainer: Luffy Status: ready -->
 <sect1 xml:id="install.windows.apache2" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- <title>Microsoft Windows 下的 Apache 2.x</title>
+ <title>在Windows系统上安装 Apache 2.x</title> 
  <para>
   本节包括在 Microsoft Windows 系统中针对 Apache 2.x 安装 PHP 的指导与说明。
  </para>
@@ -32,6 +31,11 @@
 
  <sect2 xml:id="install.windows.apache2.module">
   <title>以 Apache handler 方式安装</title>
+  <note>
+   <simpara>
+    在使用 apache2handler SAPI 时，必须使用线程安全 (TS) 版本的 PHP。
+   </simpara>
+  </note>
   <para>
    需要将以下几行加入到 Apache 的 &httpd.conf; 配置文件中以加载 Apache 2.x 的 PHP 模块：
    <example>

diff --git a/install/windows/commandline.xml b/install/windows/commandline.xml
@@ -1,16 +1,14 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- $Revision$ -->
-<!-- $Author$ -->
-<!-- Reviewed: dallas Maintainer: dallas -->
-<!-- EN-Revision: 8e732e84a1425cf0ab3a5b0da8fe113c7a6da85e Maintainer: Luffy Status: ready -->
+<!-- EN-Revision: 2dbf3d9064d4cb07f0a2f7d06641c877a2e5ed24 Maintainer: Luffy Status: ready -->
 <sect1 xml:id="install.windows.commandline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- <title>PHP 在 Microsoft Windows 下的命令行方式</title>
+ <title>在 Windows 系统上的命令行上运行 PHP</title>
  <para>
   本章包含有针对在 Windows 下以命令行运行 PHP 的说明与提示。
  </para>
  <note>
   <para>
-   应该先阅读 <link linkend="install.windows.manual"> 手工安装步骤</link>！
+   阅读 <link linkend="install.windows.manual"> 手工安装步骤</link>！
   </para>
  </note>
  <para>
@@ -132,7 +130,7 @@ Windows Registry Editor Version 5.00
 "C:\PHP Scripts\script" -arg1 -arg2 -arg3
 ]]>
   </screen>
-  或者如果 <literal>"C:\PHP Scripts"</literal> 路径位于
+  或者如果 <literal>"C:\PHP Scripts"</literal> 目录位于
   <envar>PATH</envar> 环境变量中的话：
   <screen>
 <![CDATA[
@@ -143,7 +141,7 @@ script -arg1 -arg2 -arg3
 
  <note>
   <para>
-   不过如果想要通过此技巧将 PHP 脚本作为命令行管道过滤器的话，有个小问题。例如以下例子：
+   当打算使用这种技术作为命令行过滤器运行 PHP 脚本时，会出现一个小问题，例如以下例子：
    <screen>
 <![CDATA[
 dir | "C:\PHP Scripts\script" -arg1 -arg2 -arg3
@@ -155,7 +153,8 @@ dir | "C:\PHP Scripts\script" -arg1 -arg2 -arg3
 dir | script -arg1 -arg2 -arg3
 ]]>
    </screen>
-   此时脚本只是挂起，没有输出任何内容。要解决此问题，还需要做一个注册表修改。
+   脚本可能会直接挂起，没有任何输出。
+   要使其正常运行，需要对注册表进行另一项更改：
    <screen>
 <![CDATA[
 Windows Registry Editor Version 5.00

diff --git a/install/windows/tools.xml b/install/windows/tools.xml
@@ -1,20 +1,15 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: c55dde8f549a2f939adfd924fe6e6d242c7754d3 Maintainer: Luffy Status: ready -->
-<!-- Reviewed: no -->
+<!-- EN-Revision: 2dbf3d9064d4cb07f0a2f7d06641c877a2e5ed24 Maintainer: Luffy Status: ready -->
 <sect1 xml:id="install.windows.tools" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- <title>Windows 下的 PHP 安装程序工具</title>
-
- <sect2>
-  <title>PHP 安装工具</title>
-  <para>Windows 下使用 Apache 安装 PHP 应用程序： <link xlink:href="https://www.apachefriends.org/index.html">XAMPP</link> 、WampServer 和 BitNami。
-  </para>
-  <para>
-   在 Windows 上设置和配置 Nginx 需要更多的配置。
-   参见 <link xlink:href="https://www.nginx.com/resources/wiki/start/topics/examples/phpfastcgionwindows/">Nginx文档</link>
-   来获取更多的设置帮助。
-  </para>
- </sect2>
+ <title>用于安装 PHP 的第三方工具</title>
+ &warn.install.third-party-support;
+ <para>
+  <link xlink:href="https://www.apachefriends.org/">XAMPP</link>、
+  <link xlink:href="https://www.wampserver.com">WampServer</link> 和
+  <link xlink:href="https://bitnami.com">Bitnami</link>
+  也会在 Windows 上使用 Apache 安装 PHP 应用程序。
+ </para>
 </sect1>
 <!-- Keep this comment at the end of the file
 Local variables:

diff --git a/reference/pcntl/constants.xml b/reference/pcntl/constants.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 3535c3901f9e31d75d2ef3c47b9f835c79f3757a Maintainer: Luffy Status: ready -->
+<!-- EN-Revision: 4ac5624be0dc8484a333514b605150e73cad06b8 Maintainer: Luffy Status: ready -->
 <appendix xml:id="pcntl.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
  <para>
@@ -42,6 +42,36 @@
     </simpara>
    </listitem>
   </varlistentry>
+  <varlistentry xml:id="constant.wexited">
+   <term>
+    <constant>WEXITED</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.wstopped">
+   <term>
+    <constant>WSTOPPED</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.wnowait">
+   <term>
+    <constant>WNOWAIT</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+    </simpara>
+   </listitem>
+  </varlistentry>
  </variablelist>
 
  <variablelist xml:id="pcntl.constants.sig">
@@ -1138,7 +1168,7 @@
  </variablelist>
 
  <variablelist xml:id="pcntl.constants.prio">
-  <title>PRIO_* constants</title>
+  <title>PRIO_* 常量</title>
   <varlistentry xml:id="constant.prio-pgrp">
    <term>
     <constant>PRIO_PGRP</constant>
@@ -1196,7 +1226,7 @@
   </varlistentry>
  </variablelist>
  <variablelist xml:id="pcntl.constants.fork">
-  <title>FORK_* constants</title>
+  <title>FORK_* 常量</title>
   <varlistentry xml:id="constant.fork-nosigchld">
    <term>
     <constant>FORK_NOSIGCHLD</constant>
@@ -1219,7 +1249,7 @@
   </varlistentry>
  </variablelist>
  <variablelist xml:id="pcntl.constants.rf">
-  <title>RF* constants</title>
+  <title>RF* 常量</title>
   <varlistentry xml:id="constant.rfcfdg">
    <term>
     <constant>RFCFDG</constant>
@@ -1291,6 +1321,102 @@
    </listitem>
   </varlistentry>
  </variablelist>
+<variablelist xml:id="pcntl.constants.waitid">
+ <title><literal>waitid</literal>的第一个参数（<literal>idtype</literal>）</title>
+  <varlistentry xml:id="constant.p-all">
+   <term>
+    <constant>P_ALL</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     选择任何子进程。
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.p-pid">
+   <term>
+    <constant>P_PID</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     按进程 ID 选择。
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.p-pgid">
+   <term>
+    <constant>P_PGID</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     按进程组 ID 选择。
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.p-pidfd">
+   <term>
+    <constant>P_PIDFD</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     按 PID 文件描述符选择。
+     仅适用于 Linux（自 Linux 5.4 起）。
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.p-uid">
+   <term>
+    <constant>P_UID</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     按有效用户 ID 选择。
+     仅适用于 NetBSD 和 FreeBSD。
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.p-gid">
+   <term>
+    <constant>P_GID</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     按有效组 ID 选择。
+     仅适用于 NetBSD 和 FreeBSD。
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.p-sid">
+   <term>
+    <constant>P_SID</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     按会话 ID 选择。
+     仅适用于 NetBSD 和 FreeBSD。
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.p-jailid">
+   <term>
+    <constant>P_JAILID</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     按 jail 标识符选择。
+     仅适用于 FreeBSD。
+    </simpara>
+   </listitem>
+  </varlistentry>
+ </variablelist>
 </appendix>
 <!-- Keep this comment at the end of the file
 Local variables: