[DOC-CVS] [doc-en] master: POSIX: add changelog entries for PHP 8.5 changes (#5534)
[email protected] (Louis-Arnaud via GitHub) Wed, 13 May 2026 18:37:41 +0000
| Newsgroups | php.doc.cvs |
|---|---|
| Message-ID | <[email protected]> |
Author: Louis-Arnaud (lacatoire)
Committer: GitHub (web-flow)
Pusher: jordikroon
Date: 2026-05-13T20:37:38+02:00
Commit: https://github.com/php/doc-en/commit/42ed815ea41bc1ceb3c1417e1aa8778d327e314a
Raw diff: https://github.com/php/doc-en/commit/42ed815ea41bc1ceb3c1417e1aa8778d327e314a.diff
POSIX: add changelog entries for PHP 8.5 changes (#5534)
* POSIX: add changelog entries for PHP 8.5 changes
Documented in appendices/migration85, missing from per-function changelogs:
- posix_kill: ValueError on out-of-range process_id
- posix_setpgid: ValueError on out-of-range process_id/process_group_id
- posix_setrlimit: ValueError on invalid hard_limit/soft_limit
- posix_ttyname: last_error EBADF on invalid file_descriptor
- posix_isatty: E_WARNING on invalid file_descriptor
- posix_fpathconf: last_error EBADF + E_WARNING on invalid file_descriptor
Changed paths:
M reference/posix/functions/posix-fpathconf.xml
M reference/posix/functions/posix-isatty.xml
M reference/posix/functions/posix-kill.xml
M reference/posix/functions/posix-setpgid.xml
M reference/posix/functions/posix-setrlimit.xml
M reference/posix/functions/posix-ttyname.xml
Diff:
diff --git a/reference/posix/functions/posix-fpathconf.xml b/reference/posix/functions/posix-fpathconf.xml
index 69e51cbc8b4a..f8e7f44151e1 100644
--- a/reference/posix/functions/posix-fpathconf.xml
+++ b/reference/posix/functions/posix-fpathconf.xml
@@ -55,6 +55,30 @@
</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.5.0</entry>
+ <entry>
+ Now sets <varname>last_error</varname> to <constant>EBADF</constant>
+ and raises an <constant>E_WARNING</constant> when an invalid file
+ descriptor is encountered.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<example xml:id="function.posix-fpathconf.example.basic">
diff --git a/reference/posix/functions/posix-isatty.xml b/reference/posix/functions/posix-isatty.xml
index 9b22f3c08549..e7bc6742a4a5 100644
--- a/reference/posix/functions/posix-isatty.xml
+++ b/reference/posix/functions/posix-isatty.xml
@@ -46,6 +46,13 @@
</row>
</thead>
<tbody>
+ <row>
+ <entry>8.5.0</entry>
+ <entry>
+ Now raises an <constant>E_WARNING</constant> when an invalid
+ <parameter>file_descriptor</parameter> is encountered.
+ </entry>
+ </row>
<row>
<entry>8.4.0</entry>
<entry>
diff --git a/reference/posix/functions/posix-kill.xml b/reference/posix/functions/posix-kill.xml
index b3556814c8fb..34b88dec552d 100644
--- a/reference/posix/functions/posix-kill.xml
+++ b/reference/posix/functions/posix-kill.xml
@@ -50,6 +50,30 @@
</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.5.0</entry>
+ <entry>
+ Now throws a <exceptionname>ValueError</exceptionname> when
+ <parameter>process_id</parameter> is lower or greater than what
+ the platform supports (signed integer or long range).
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
diff --git a/reference/posix/functions/posix-setpgid.xml b/reference/posix/functions/posix-setpgid.xml
index 273c53a3903c..32b281f82bef 100644
--- a/reference/posix/functions/posix-setpgid.xml
+++ b/reference/posix/functions/posix-setpgid.xml
@@ -50,6 +50,30 @@
</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.5.0</entry>
+ <entry>
+ Now throws a <exceptionname>ValueError</exceptionname> when
+ <parameter>process_id</parameter> or <parameter>process_group_id</parameter>
+ is lower than zero or greater than what the platform supports.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
diff --git a/reference/posix/functions/posix-setrlimit.xml b/reference/posix/functions/posix-setrlimit.xml
index f542d5c1ff7d..763ed525b58b 100644
--- a/reference/posix/functions/posix-setrlimit.xml
+++ b/reference/posix/functions/posix-setrlimit.xml
@@ -64,6 +64,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.5.0</entry>
+ <entry>
+ Now throws a <exceptionname>ValueError</exceptionname> when
+ <parameter>hard_limit</parameter> or <parameter>soft_limit</parameter>
+ is lower than -1, or when <parameter>soft_limit</parameter> is greater
+ than <parameter>hard_limit</parameter>.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
diff --git a/reference/posix/functions/posix-ttyname.xml b/reference/posix/functions/posix-ttyname.xml
index 4c9a76bc82f1..c17d500f7f35 100644
--- a/reference/posix/functions/posix-ttyname.xml
+++ b/reference/posix/functions/posix-ttyname.xml
@@ -55,6 +55,13 @@
</row>
</thead>
<tbody>
+ <row>
+ <entry>8.5.0</entry>
+ <entry>
+ <varname>last_error</varname> is now set to <constant>EBADF</constant>
+ when an invalid <parameter>file_descriptor</parameter> is encountered.
+ </entry>
+ </row>
<row>
<entry>8.3.0</entry>
<entry>