Commit 663efacb910 for php.net

commit 663efacb91060d3ae3b0f0eb0980c3cb396cd02d
Author: Gina Peter Banyard <girgias@php.net>
Date:   Fri Apr 10 19:38:41 2026 +0100

    Update UPGRADING/NEWS for ValueErrors

    Also move the new ValueErrors into the correct section

diff --git a/NEWS b/NEWS
index f39dd0954a5..a7ad6778875 100644
--- a/NEWS
+++ b/NEWS
@@ -154,6 +154,8 @@ PHP                                                                        NEWS
     (David Carlier)
   . Passing an invalid flag value to the second argument of scandir() will now
     throw a ValueError. (alexandre-daubois)
+  . array_change_key_case() now raises a ValueError when an invalid $case
+    argument value is passed. (Girgias)

 - Streams:
   . Added so_keepalive, tcp_keepidle, tcp_keepintvl and tcp_keepcnt stream
diff --git a/UPGRADING b/UPGRADING
index 33717ac1ed5..e9944d8eeeb 100644
--- a/UPGRADING
+++ b/UPGRADING
@@ -19,14 +19,29 @@ PHP 8.6 UPGRADE NOTES
 1. Backward Incompatible Changes
 ========================================

+- GD:
+  . imagesetstyle(), imagefilter() and imagecrop() filter their
+    array arguments types/values and raise a TypeError/ValueError
+    accordingly.
+
 - PCRE:
   . preg_grep() now returns false instead of a partial array when a PCRE
     execution error occurs (e.g. malformed UTF-8 input with the /u modifier).
     This is consistent with other preg_* functions.

+- PCNTL:
+  . pcntl_alarm() now raises a ValueError if the seconds argument is
+    lower than zero or greater than platform's UINT_MAX.
+
 - Phar:
-  . Invalid values now throw in Phar::mungServer() instead of being silently
-    ignored.
+  . Phar::mungServer() now raises a ValueError when an invalid
+    argument value is passed instead of being silently ignored.
+
+- Posix:
+  . posix_access() now raises a ValueError when an invalid $flags
+    argument value is passed.
+  . posix_mkfifo() now raises a ValueError when an invalid $permissions
+    argument value is passed.

 - Session:
   . A ValueError is not thrown if $name is a string containing null bytes in
@@ -45,10 +60,21 @@ PHP 8.6 UPGRADE NOTES
     logic in their updateTimestamp() method.

 - Standard:
-  . Invalid mode values now throw in array_filter() instead of being silently
-    defaulted to 0.
   . Form feed (\f) is now added in the default trimmed characters of trim(),
     rtrim() and ltrim(). RFC: https://wiki.php.net/rfc/trim_form_feed
+  . array_filter() now raises a ValueError when an invalid $mode
+    argument value is passed.
+  . array_change_key_case() now raises a ValueError when an invalid $case
+    argument value is passed.
+  . pathinfo() now raises a ValueError when an invalid $flag
+    argument value is passed.
+  . scandir() now raises a ValueError when an invalid $sorting_order
+    argument value is passed.
+
+- Zip:
+  . ZipArchive::extractTo now raises a TypeError for the
+    files argument if one or more of the entries is not
+    a string.

 ========================================
 2. New Features
@@ -103,11 +129,6 @@ PHP 8.6 UPGRADE NOTES
 5. Changed Functions
 ========================================

-- GD:
-  . imagesetstyle(), imagefilter() and imagecrop() filter their
-    array arguments types/values and raise a TypeError/ValueError
-    accordingly.
-
 - mysqli:
   . The return structure of mysqli_get_charset() no longer contains
     the undocumented "comment" element. The value of "charsetnr" is
@@ -118,35 +139,14 @@ PHP 8.6 UPGRADE NOTES
   . Output of openssl_x509_parse() contains criticalExtensions listing all
     critical certificate extensions.

-- PCNTL:
-  . pcntl_alarm() now throws a ValueError if the seconds argument is
-    lower than zero or greater than platform's UINT_MAX.
-
 - Phar:
   . Phar::mungServer() now supports reference values.

-- Posix:
-  . posix_access() now throws a ValueError exception if the flags
-    argument is invalid.
-  . posix_mkfifo() now throws a ValueError exception if the permissions
-    argument is invalid.
-
 - Sockets:
   . socket_addrinfo_lookup() now has an additional optional argument $error
     when not null, and on failure, gives the error code (one of the EAI_*
     constants).

-- Standard:
-  . pathinfo() now raises a ValueError when an invalid $flag argument
-    value is passed.
-  . scandir() now raises a ValueError when an invalid $sorting_order
-    argument value is passed.
-
-- Zip:
-  . ZipArchive::extractTo now raises a TypeError for the
-    files argument if one or more of the entries is not
-    a string.
-
 ========================================
 6. New Functions
 ========================================