[DOC-CVS] [doc-en] master: hash: Fix changelog to mention E_WARNING (#5271)

Author: Louis-Arnaud (lacatoire)
Committer: GitHub (web-flow)
Pusher: jordikroon
Date: 2026-05-13T20:33:37+02:00

Commit: https://github.com/php/doc-en/commit/df2a77acbbb9d381426b863fcfa4d66ac7f5ab6d
Raw diff: https://github.com/php/doc-en/commit/df2a77acbbb9d381426b863fcfa4d66ac7f5ab6d.diff

hash: Fix changelog to mention E_WARNING (#5271)

* Fix hash functions changelog to mention E_WARNING

Fixes #3480

Co-authored-by: Jordi Kroon <[email protected]>

Changed paths:
  M  reference/hash/functions/hash-hmac-file.xml
  M  reference/hash/functions/hash-hmac.xml
  M  reference/hash/functions/hash.xml


Diff:

diff --git a/reference/hash/functions/hash-hmac-file.xml b/reference/hash/functions/hash-hmac-file.xml
index 00fa1977d9a9..b98c42d969f6 100644
--- a/reference/hash/functions/hash-hmac-file.xml
+++ b/reference/hash/functions/hash-hmac-file.xml
@@ -98,7 +98,8 @@
        <entry>
         Now throws a <classname>ValueError</classname> exception if
         <parameter>algo</parameter> is unknown or is a non-cryptographic hash
-        function; previously, &false; was returned instead.
+        function; previously, &false; was returned
+        and an <constant>E_WARNING</constant> message was emitted.
        </entry>
       </row>
       <row>
diff --git a/reference/hash/functions/hash-hmac.xml b/reference/hash/functions/hash-hmac.xml
index c2a28f6799e4..b8c0797a4bcc 100644
--- a/reference/hash/functions/hash-hmac.xml
+++ b/reference/hash/functions/hash-hmac.xml
@@ -98,7 +98,8 @@
        <entry>
         Now throws a <classname>ValueError</classname> exception if
         <parameter>algo</parameter> is unknown or is a
-        non-cryptographic hash function; previously, &false; was returned instead.
+        non-cryptographic hash function; previously, &false; was returned
+        and an <constant>E_WARNING</constant> message was emitted.
        </entry>
       </row>
       <row>
diff --git a/reference/hash/functions/hash.xml b/reference/hash/functions/hash.xml
index 598d21f4792e..bb8e5f48e939 100644
--- a/reference/hash/functions/hash.xml
+++ b/reference/hash/functions/hash.xml
@@ -69,6 +69,14 @@
   </para>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <simpara>
+   Throws a <exceptionname>ValueError</exceptionname> exception if
+   <parameter>algo</parameter> is unknown.
+  </simpara>
+ </refsect1>
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <para>
@@ -88,8 +96,9 @@
       <row>
        <entry>8.0.0</entry>
        <entry>
-        <function>hash</function> now throws a <classname>ValueError</classname> exception
-        if <parameter>algo</parameter> is unknown; previously, &false; was returned instead.
+        Now throws a <exceptionname>ValueError</exceptionname> exception
+        if <parameter>algo</parameter> is unknown; previously, &false; was returned
+        and an <constant>E_WARNING</constant> message was emitted.
        </entry>
       </row>
      </tbody>