[DOC-CVS] [doc-en] master: mysqli: document wait-timeout error code change 2006 -> 4031 (8.4.0) (#5783)

Author: Louis-Arnaud (lacatoire)
Committer: GitHub (web-flow)
Pusher: lacatoire
Date: 2026-08-24T12:03:05+02:00

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

mysqli: document wait-timeout error code change 2006 -> 4031 (8.4.0) (#5783)

As of PHP 8.4.0, when connecting to MySQL 8.0.24+, the error code
for a server wait timeout changes from 2006 (CR_SERVER_GONE_ERROR)
to 4031 (ER_CLIENT_INTERACTION_TIMEOUT).

Changed paths:
  M  reference/mysqli/mysqli/query.xml


Diff:

diff --git a/reference/mysqli/mysqli/query.xml b/reference/mysqli/mysqli/query.xml
index 23c9a32c60aa..632d373175e4 100644
--- a/reference/mysqli/mysqli/query.xml
+++ b/reference/mysqli/mysqli/query.xml
@@ -131,6 +131,33 @@
   &mysqli.conditionalexception;
  </refsect1>
 
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        When connecting to MySQL 8.0.24 or later, the error code reported
+        for a server wait timeout is now <literal>4031</literal>
+        (<literal>ER_CLIENT_INTERACTION_TIMEOUT</literal>) instead of
+        <literal>2006</literal> (<literal>CR_SERVER_GONE_ERROR</literal>).
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <example>