From 300788af82db7e6a2fa069d1aa7a7f150e709160 Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Wed, 18 Feb 2026 11:38:51 +0100
Subject: [PATCH] Document ValueError thrown by settype() since PHP 8.0

Add Errors/Exceptions section and changelog entry.

Fixes php/doc-en#3431
---
 reference/var/functions/settype.xml | 35 +++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/reference/var/functions/settype.xml b/reference/var/functions/settype.xml
index 3700d30e64ab..0cf24423dc77 100644
--- a/reference/var/functions/settype.xml
+++ b/reference/var/functions/settype.xml
@@ -87,6 +87,41 @@
   </para>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <para>
+   Throws a <exceptionname>ValueError</exceptionname> if the value of
+   <parameter>type</parameter> is not a valid type, as of PHP 8.0.0.
+   Prior to PHP 8.0.0, a <constant>E_WARNING</constant> was emitted
+   and &false; was returned.
+  </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       Now throws a <exceptionname>ValueError</exceptionname> when an invalid
+       type is passed to <parameter>type</parameter>. Previously, a
+       <constant>E_WARNING</constant> was emitted and the function returned
+       &false;.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>