[DOC-CVS] [doc-en] master: Clarify how multi_query works (#5380)

Author: Kamil Tekiela (kamil-tekiela)
Committer: GitHub (web-flow)
Pusher: kamil-tekiela
Date: 2026-02-18T22:58:14Z

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

Clarify how multi_query works (#5380)

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


Diff:

diff --git a/reference/mysqli/mysqli/multi-query.xml b/reference/mysqli/mysqli/multi-query.xml
index 3a0931d3f820..6869ef2ffc75 100644
--- a/reference/mysqli/mysqli/multi-query.xml
+++ b/reference/mysqli/mysqli/multi-query.xml
@@ -25,12 +25,11 @@
   </para>
   &mysqli.sqlinjection.warning;
   <para>
-   Queries are sent asynchronously in a single call to the database, but the
-   database processes them sequentially.
+   Queries are sent in a single call to the database and processed sequentially.
    <methodname>mysqli_multi_query</methodname> waits for the first query to
-   complete before returning control to PHP. The MySQL server will then process
-   the next query in the sequence. Once the next result is ready, MySQL will wait
-   for the next execution of <function>mysqli_next_result</function> from PHP.
+   complete before returning control to PHP. In the meantime, the MySQL server
+   will continue processing the remaining queries asynchronously of PHP and make
+   the results available for fetching.
   </para>
   <para>
    It is recommended to use