From 5b3fc18be040c1d552da1497415b20296163012f Mon Sep 17 00:00:00 2001
From: Yann 'Ze' Richard <Zeuh@users.noreply.github.com>
Date: Mon, 6 Jun 2022 16:28:30 +0200
Subject: [PATCH] Fix GH-1611: mb-internal-encoding() throws ValueError on
 unknown encoding

Closes GH-1613.

Signed-off-by: Yann 'Ze' Richard <ze@nbox.org>
---
 .../mbstring/functions/mb-internal-encoding.xml | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/reference/mbstring/functions/mb-internal-encoding.xml b/reference/mbstring/functions/mb-internal-encoding.xml
index fcc4ee0fe9..00261a2402 100644
--- a/reference/mbstring/functions/mb-internal-encoding.xml
+++ b/reference/mbstring/functions/mb-internal-encoding.xml
@@ -48,6 +48,15 @@
   </para>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <para>
+   As of PHP 8.0.0, a <classname>ValueError</classname> is thrown if the
+   value of <parameter>encoding</parameter> is an invalid encoding.
+   Prior to PHP 8.0.0, a <constant>E_WARNING</constant> was emitted instead.
+  </para>
+ </refsect1>
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <informaltable>
@@ -60,6 +69,14 @@
     </thead>
     <tbody>
      &mbstring.changelog.encoding-nullable;
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       Now throws a <classname>ValueError</classname> if
+       <parameter>encoding</parameter> is an invalid encoding.
+       Previously a <constant>E_WARNING</constant> was emitted instead.
+      </entry>
+     </row>
     </tbody>
    </tgroup>
   </informaltable>