From 91e42bab2c02fe5e6f694d8e51c37559c1369d6d Mon Sep 17 00:00:00 2001
From: Louis-Arnaud Catoire <la.catoire@gmail.com>
Date: Sun, 1 Feb 2026 21:42:53 +0100
Subject: [PATCH] Document ValueError for empty filename in getimagesize()

---
 reference/image/functions/getimagesize.xml | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/reference/image/functions/getimagesize.xml b/reference/image/functions/getimagesize.xml
index 3f1ca5613fa7..22e187476a39 100644
--- a/reference/image/functions/getimagesize.xml
+++ b/reference/image/functions/getimagesize.xml
@@ -185,6 +185,10 @@ if ($size && $fp) {
    <function>getimagesize</function> will generate an error of level
    <constant>E_NOTICE</constant>.
   </para>
+  <para>
+   As of PHP 8.0.0, a <exceptionname>ValueError</exceptionname> is thrown
+   if <parameter>filename</parameter> is empty.
+  </para>
  </refsect1>
 
  <refsect1 role="changelog">
@@ -207,6 +211,14 @@ if ($size && $fp) {
         and bits and channels were not reported at all.
        </entry>
       </row>
+      <row>
+       <entry>8.0.0</entry>
+       <entry>
+        A <exceptionname>ValueError</exceptionname> is now thrown if
+        <parameter>filename</parameter> is empty; previously an
+        <constant>E_WARNING</constant> was raised and the function returned &false;.
+       </entry>
+      </row>
       <row>
        <entry>7.1.0</entry>
        <entry>