From f7713b22d571b7078544974b5fa4ee4bcdf1122b Mon Sep 17 00:00:00 2001
From: Emre ULUSOY <emre.ulusoy@epita.fr>
Date: Wed, 9 Jul 2025 22:04:26 +0200
Subject: [PATCH] Document boolean support for allowed_classes in unserialize

- In appendices/migration84/incompatible.xml, update the description of the
  allowed_classes option to indicate it may be an array of class names or at
  boolean.
- In reference/var/functions/unserialize.xml, clarify that unserialize() throws
  TypeError and ValueError if options.allowed_classes is not an array or boolean.
---
 appendices/migration84/incompatible.xml |  6 +++---
 reference/var/functions/unserialize.xml | 13 +++++++------
 2 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/appendices/migration84/incompatible.xml b/appendices/migration84/incompatible.xml
index 44ccfe2b4334..03e8cc691a60 100644
--- a/appendices/migration84/incompatible.xml
+++ b/appendices/migration84/incompatible.xml
@@ -409,9 +409,9 @@
    <simpara>
     The <literal>"allowed_classes"</literal> option for
     <function>unserialize</function> now throws
-    <exceptionname>TypeError</exceptionname>s and
-    <exceptionname>ValueError</exceptionname>s if it is not an
-    <type>array</type> of class names.
+    <exceptionname>TypeError</exceptionname> and
+    <exceptionname>ValueError</exceptionname> if it is neither an
+    <type>array</type> of class names nor a <type>boolean</type>.
    </simpara>
   </sect3>
 
diff --git a/reference/var/functions/unserialize.xml b/reference/var/functions/unserialize.xml
index 7dfee0a6968a..7c75b6c20857 100644
--- a/reference/var/functions/unserialize.xml
+++ b/reference/var/functions/unserialize.xml
@@ -146,9 +146,9 @@
   </simpara>
   <simpara>
    As of PHP 8.4.0, if the <literal>allowed_classes</literal> element of
-   <parameter>options</parameter> is not an <type>array</type> of class names,
-   <function>unserialize</function> throws <exceptionname>TypeError</exceptionname>s
-   and <exceptionname>ValueError</exceptionname>s.
+   <parameter>options</parameter> is neither a <type>array</type> of class names
+   nor a <type>boolean</type>, <function>unserialize</function> throws
+   <exceptionname>TypeError</exceptionname> and <exceptionname>ValueError</exceptionname>.
   </simpara>
  </refsect1>
 
@@ -167,9 +167,10 @@
       <row>
        <entry>8.4.0</entry>
        <entry>
-        Now throws <exceptionname>TypeError</exceptionname>s and
-        <exceptionname>ValueError</exceptionname>s if the <literal>allowed_classes</literal>
-        element of <parameter>options</parameter> is not an <type>array</type> of class names.
+        Now throws <exceptionname>TypeError</exceptionname> and
+        <exceptionname>ValueError</exceptionname> if the <literal>allowed_classes</literal>
+        element of <parameter>options</parameter> is neither a <type>array</type> of class names
+        nor a <type>boolean</type>.
        </entry>
       </row>
       <row>