Update oci8/pcntl

php · Jan 17, 2025 · e6623e1 · e6623e1
1 parent 38cd583
commit e6623e1
Show file tree

Hide file tree

Showing 5 changed files with 152 additions and 17 deletions.
diff --git a/reference/oci8/book.xml b/reference/oci8/book.xml
@@ -1,14 +1,19 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: b9e6268918813e27972c644897970b0cdbc6f86e Maintainer: mowangjuanzi Status: ready -->
+<!-- EN-Revision: 86177fa035acc7fdb972855bdd6c0b19edd505cd Maintainer: mowangjuanzi Status: ready -->
 <book xml:id="book.oci8" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- <?phpdoc extension-membership="bundledexternal" ?>
+ <?phpdoc extension-membership="pecl" ?>
  <title>Oracle OCI8</title>
  <titleabbrev>OCI8</titleabbrev>
 
  <!-- {{{ preface -->
  <preface xml:id="intro.oci8">
   &reftitle.intro;
+  <warning>
+   <simpara>
+    自 PHP 8.4.0 起，此扩展不再<emphasis>捆绑</emphasis>。
+   </simpara>
+  </warning>
   <para>
    这些函数允许访问 Oracle 数据库。支持 SQL 和 PL/SQL 语句。基本功能包括对事务控制、PHP 变量与 Oracle
    占位符的绑定以及大对象（LOB）类型和集合的支持。还支持 Oracle 的可伸缩性特性，例如数据库驻留连接池（DRCP）和结果缓存。

diff --git a/reference/pcntl/book.xml b/reference/pcntl/book.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 508e255fff6c604c31d5617fe9ddf6d776a3b43d Maintainer: mowangjuanzi Status: ready -->
+<!-- EN-Revision: ee8d203f9230b0496f6d69cc1237d9ca63475ad7 Maintainer: mowangjuanzi Status: ready -->
 <book xml:id="book.pcntl" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <?phpdoc extension-membership="bundled" ?>
  <title>进程控制</title>
@@ -10,32 +10,34 @@
  <preface xml:id="intro.pcntl">
   &reftitle.intro;
   <para>
-   PHP 的进程控制支持实现了 Unix 方式的进程创建, 程序执行, 信号处理以及进程的中断。
-   进程控制不能被应用在 Web 服务器环境，当其被用于 Web 服务环境时可能会带来意外的结果。
+   PHP 的进程控制支持实现了 Unix 方式的进程创建, 程序执行, 信号处理以及进程的中断。进程控制不能被应用在
+   Web 服务器环境，当其被用于 Web 服务环境时可能会带来意外的结果。
   </para>
   <para>
-   这份文档用于阐述每个进程控制函数的通常用法。关于 Unix 进程控制的更多信息建议查阅
-   系统文档中关于 fork（2）、waitpid（2）、signal（2）等的部分或更全面的参考资料比如
-   《Unix 环境高级编程》（作者：W. Richard Stevens、Addison-Wesley 出版）。
+   这份文档用于阐述每个进程控制函数的通常用法。关于 Unix 进程控制的更多信息建议查阅系统文档中关于
+   fork（2）、waitpid（2）、signal（2）等的部分或更全面的参考资料比如《Unix
+   环境高级编程》（作者：W. Richard Stevens、Addison-Wesley 出版）。
   </para>
   <para>
-   PCNTL 现在使用了 ticks 作为信号处理的回调机制，ticks 在速度上远远超过了之前的处理机制。
-   这个变化与“用户 ticks”遵循了相同的语义。您可以使用 <function>declare</function>
-   语句在程序中指定允许发生回调的位置。这使得我们对异步事件处理的开销最小化。在编译 PHP 时
-   启用 pcntl 将始终承担这种开销，不论脚本中是否真正使用了 pcntl。
+   PCNTL 现在使用了 ticks 作为信号处理的回调机制，ticks 在速度上远远超过了之前的处理机制。这个变化与“用户
+   ticks”遵循了相同的语义。您可以使用 <function>declare</function>
+   语句在程序中指定允许发生回调的位置。这使得我们对异步事件处理的开销最小化。在编译 PHP 时启用
+   pcntl 将始终承担这种开销，不论脚本中是否真正使用了 pcntl。
   </para>
 
   &note.no-windows.extension;
  </preface>
  <!-- }}} -->
- 
+
  &reference.pcntl.setup;
  &reference.pcntl.constants;
  &reference.pcntl.examples;
+
+ &reference.pcntl.qosclass;
+
  &reference.pcntl.reference;
 
 </book>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

diff --git a/reference/pcntl/functions/pcntl-sigprocmask.xml b/reference/pcntl/functions/pcntl-sigprocmask.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: b890f28c0c6d2856eadcdc34b3faf83a846b3d79 Maintainer: mowangjuanzi Status: ready -->
+<!-- EN-Revision: 7bc131d65540e2a0f706cf4d99b5a3235c965fdb Maintainer: mowangjuanzi Status: ready -->
 <refentry xml:id="function.pcntl-sigprocmask" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>pcntl_sigprocmask</refname>
@@ -64,6 +64,47 @@
   </para>
  </refsect1>
 
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       如果 <parameter>signal</parameter> 为空，则抛出 <classname>ValueError</classname>。
+      </entry>
+     </row>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       如果 <parameter>signal</parameter> 的值不是 <type>int</type>，则抛出 <classname>TypeError</classname>。
+      </entry>
+     </row>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       如果 <parameter>signal</parameter> 的值无效，则抛出 <classname>ValueError</classname>。
+      </entry>
+     </row>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       如果 <parameter>mode</parameter> 的值不是 <constant>SIG_BLOCK</constant>、<constant>SIG_UNBLOCK</constant>
+       或 <constant>SIG_SETMASK</constant>，则抛出 <classname>ValueError</classname>。
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>

diff --git a/reference/pcntl/functions/pcntl-sigtimedwait.xml b/reference/pcntl/functions/pcntl-sigtimedwait.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: b890f28c0c6d2856eadcdc34b3faf83a846b3d79 Maintainer: mowangjuanzi Status: ready -->
+<!-- EN-Revision: 7bc131d65540e2a0f706cf4d99b5a3235c965fdb Maintainer: mowangjuanzi Status: ready -->
 <refentry xml:id="function.pcntl-sigtimedwait" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>pcntl_sigtimedwait</refname>
@@ -71,6 +71,59 @@
   </para>
  </refsect1>
 
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       如果 <parameter>signal</parameter> 为空，则抛出 <classname>ValueError</classname>。
+      </entry>
+     </row>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       如果 <parameter>signal</parameter> 的值不是 <type>int</type>，则抛出 <classname>TypeError</classname>。
+      </entry>
+     </row>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       如果 <parameter>signal</parameter> 的值无效，则抛出 <classname>ValueError</classname>。
+      </entry>
+     </row>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       如果 <parameter>seconds</parameter> 的值小于 <literal>0</literal>，则抛出 <classname>ValueError</classname>。
+      </entry>
+     </row>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       如果 <parameter>nanoseconds</parameter> 的值小于 <literal>0</literal>，则抛出 <classname>ValueError</classname>。
+      </entry>
+     </row>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       如果 <parameter>seconds</parameter> 和 <parameter>nanoseconds</parameter> 的值都是
+       <literal>0</literal>，则抛出 <classname>ValueError</classname>。
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>

diff --git a/reference/pcntl/functions/pcntl-sigwaitinfo.xml b/reference/pcntl/functions/pcntl-sigwaitinfo.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: c42d3d890578e3be848e3adc763d324884321ae8 Maintainer: mowangjuanzi Status: ready -->
+<!-- EN-Revision: 7bc131d65540e2a0f706cf4d99b5a3235c965fdb Maintainer: mowangjuanzi Status: ready -->
 <refentry xml:id="function.pcntl-sigwaitinfo" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>pcntl_sigwaitinfo</refname>
@@ -86,6 +86,40 @@
   </para>
  </refsect1>
 
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       如果 <parameter>signal</parameter> 为空，则抛出 <classname>ValueError</classname>。
+      </entry>
+     </row>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       如果 <parameter>signal</parameter> 的值不是 <type>int</type>，则抛出 <classname>TypeError</classname>。
+      </entry>
+     </row>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       如果 <parameter>signal</parameter> 的值无效，则抛出 <classname>ValueError</classname>。
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>