From 3e43d28e148ab360e5c19988e46f69ca3645f4c2 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 6 Dec 2024 10:44:22 +0100
Subject: [PATCH] [PHP 8.4] `unserialize()` can throw a `ValueError` and
 `TypeError`

---
 reference/var/functions/unserialize.xml | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/reference/var/functions/unserialize.xml b/reference/var/functions/unserialize.xml
index d39268b42605..8455aafeeb30 100644
--- a/reference/var/functions/unserialize.xml
+++ b/reference/var/functions/unserialize.xml
@@ -141,9 +141,15 @@
 
  <refsect1 role="errors">
   &reftitle.errors;
-  <para>
+  <simpara>
    Objects may throw <classname>Throwable</classname>s in their unserialization handlers.
-  </para>
+  </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.
+  </simpara>
  </refsect1>
 
  <refsect1 role="changelog">
@@ -152,6 +158,14 @@
    <informaltable>
     <tgroup cols="2">
      <thead>
+      <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.
+       </entry>
+      </row>
       <row>
        <entry>&Version;</entry>
        <entry>&Description;</entry>