Document PHP 8.3 proc_get_status() change (#4112)

* Document PHP 8.3 proc_get_status() change * Update reference/exec/functions/proc-get-status.xml Co-authored-by: Gina Peter Banyard <[email protected]> --------- Co-authored-by: Gina Peter Banyard <[email protected]>
php · Nov 21, 2024 · af704f6 · af704f6
1 parent 0e09741
commit af704f6
Showing 1 changed file with 36 additions and 2 deletions.
diff --git a/reference/exec/functions/proc-get-status.xml b/reference/exec/functions/proc-get-status.xml
@@ -90,8 +90,17 @@
       <entry>
        The exit code returned by the process (which is only
        meaningful if <literal>running</literal> is &false;).
-       Only first call of this function return real value, next calls return
-       <literal>-1</literal>.
+       Prior to PHP 8.3.0, only the first call of this function returned the real
+       value, the following calls returned <literal>-1</literal>.
+      </entry>
+     </row>
+     <row>
+      <entry>cached</entry>
+      <entry><type>bool</type></entry>
+      <entry>
+       As of PHP 8.3.0, this is &true; when the exit code is cached.
+       Caching is necessary to make sure the exit code is not lost by
+       subsequent calls to process APIs.
       </entry>
      </row>
      <row>
@@ -116,6 +125,31 @@
   </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.3.0</entry>
+      <entry>
+       The <literal>"cached"</literal> entry has been added to the returned
+       array. Prior to PHP 8.3.0, only the first call returned the real exit
+       code. The <literal>"cached"</literal> entry indicates that the exit code
+       was cached.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>