diff --git a/reference/array/functions/array-combine.xml b/reference/array/functions/array-combine.xml
index 6c5330b31fdd..9a35e3d01b48 100644
--- a/reference/array/functions/array-combine.xml
+++ b/reference/array/functions/array-combine.xml
@@ -59,11 +59,36 @@
  <refsect1 role="errors">
   &reftitle.errors;
   <para>
-   Throws <constant>E_WARNING</constant> if the number of elements in
+   As of PHP 8.0.0, a <classname>ValueError</classname> is thrown if the number of elements in
    <parameter>keys</parameter> and <parameter>values</parameter> does not
    match.
+   Prior to PHP 8.0.0, a <constant>E_WARNING</constant> was emitted instead.
   </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>
+       <function>array_combine</function> will now throw a
+       <classname>ValueError</classname> if the number of elements
+       for each array is not equal.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
  
  <refsect1 role="examples">
   &reftitle.examples;