[PHP 8.4] Add errors for GD functions (#3962)

Co-authored-by: Christoph M. Becker <cmbecker69@gmx.de>
php · Oct 29, 2024 · ccd3e68 · ccd3e68
1 parent 71618f8
commit ccd3e68
Show file tree

Hide file tree

Showing 6 changed files with 112 additions and 0 deletions.
diff --git a/reference/image/functions/imageavif.xml b/reference/image/functions/imageavif.xml
@@ -63,6 +63,37 @@
   &gd.return.trueonerror;
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <simpara>
+   Throws a <classname>ValueError</classname> if <parameter>quality</parameter>
+   or <parameter>speed</parameter> is invalid.
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       Now throws a <classname>ValueError</classname> if <parameter>quality</parameter>
+       or <parameter>speed</parameter> is invalid.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <simplelist>

diff --git a/reference/image/functions/imagefilter.xml b/reference/image/functions/imagefilter.xml
@@ -234,6 +234,16 @@
    &return.success;
   </para>
  </refsect1>
+
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <simpara>
+   Throws a <classname>ValueError</classname>
+   if <parameter>sub</parameter> or <parameter>plus</parameter> would cause over-/underflow
+   with the <constant>IMG_FILTER_SCATTER</constant> <parameter>filter</parameter>.
+  </simpara>
+ </refsect1>
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <para>
@@ -246,6 +256,14 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        Now throws a <classname>ValueError</classname>
+        if <parameter>sub</parameter> or <parameter>plus</parameter> would cause over-/underflow
+        with the <constant>IMG_FILTER_SCATTER</constant> <parameter>filter</parameter>.
+       </entry>
+      </row>
       &gd.changelog.image-param;
       <row>
        <entry>7.4.0</entry>

diff --git a/reference/image/functions/imagejpeg.xml b/reference/image/functions/imagejpeg.xml
@@ -50,6 +50,13 @@
   &gd.return.trueonerror;
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <simpara>
+   Throws a <classname>ValueError</classname> if <parameter>quality</parameter> is invalid.
+  </simpara>
+ </refsect1>
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <informaltable>
@@ -61,6 +68,12 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       Now throws a <classname>ValueError</classname> if <parameter>quality</parameter> is invalid.
+      </entry>
+     </row>
      &gd.changelog.image-param;
     </tbody>
    </tgroup>

diff --git a/reference/image/functions/imagepng.xml b/reference/image/functions/imagepng.xml
@@ -75,6 +75,13 @@
   &gd.return.trueonerror;
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <simpara>
+   Throws a <classname>ValueError</classname> if <parameter>quality</parameter> is invalid.
+  </simpara>
+ </refsect1>
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <informaltable>
@@ -86,6 +93,12 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       Now throws a <classname>ValueError</classname> if <parameter>quality</parameter> is invalid.
+      </entry>
+     </row>
      &gd.changelog.image-param;
     </tbody>
    </tgroup>

diff --git a/reference/image/functions/imagescale.xml b/reference/image/functions/imagescale.xml
@@ -76,6 +76,17 @@
   </para>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <simpara>
+   Throws a <classname>ValueError</classname> if <parameter>width</parameter>
+   or <parameter>height</parameter> would cause over-/underflow.
+  </simpara>
+  <simpara>
+   Throws a <classname>ValueError</classname> if <parameter>mode</parameter> is invalid.
+  </simpara>
+ </refsect1>
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <informaltable>
@@ -87,6 +98,19 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       Now throws a <classname>ValueError</classname> if <parameter>width</parameter>
+       or <parameter>height</parameter> would cause over-/underflow.
+      </entry>
+     </row>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       Now throws a <classname>ValueError</classname> if <parameter>mode</parameter> is invalid.
+      </entry>
+     </row>
      <row>
       <entry>8.0.0</entry>
       <entry>

diff --git a/reference/image/functions/imagewebp.xml b/reference/image/functions/imagewebp.xml
@@ -51,6 +51,13 @@
   &gd.return.trueonerror;
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <simpara>
+   Throws a <classname>ValueError</classname> if <parameter>quality</parameter> is invalid.
+  </simpara>
+ </refsect1>
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <informaltable>
@@ -62,6 +69,12 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       Now throws a <classname>ValueError</classname> if <parameter>quality</parameter> is invalid.
+      </entry>
+     </row>
      &gd.changelog.image-param;
     </tbody>
    </tgroup>