From 521d8852c5d1f10249c8356ed860ce3b51f382af Mon Sep 17 00:00:00 2001
From: lcatoire <lcatoire@carter-cash.com>
Date: Fri, 10 Jul 2026 16:13:49 +0200
Subject: [PATCH] feat(sqlite3): documenter les constantes
 Sqlite3Stmt::EXPLAIN_MODE_*
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Ajout des trois constantes de classe introduites en PHP 8.5 :
- EXPLAIN_MODE_PREPARED (0) : mode normal (pas d'EXPLAIN)
- EXPLAIN_MODE_EXPLAIN (1) : équivalent de EXPLAIN
- EXPLAIN_MODE_EXPLAIN_QUERY_PLAN (2) : équivalent de EXPLAIN QUERY PLAN

Closes #832
---
 reference/sqlite3/sqlite3stmt.xml | 61 +++++++++++++++++++++++++++++++
 reference/sqlite3/versions.xml    |  3 ++
 2 files changed, 64 insertions(+)

diff --git a/reference/sqlite3/sqlite3stmt.xml b/reference/sqlite3/sqlite3stmt.xml
index 60055cdcbb83..7a38e5e3febc 100644
--- a/reference/sqlite3/sqlite3stmt.xml
+++ b/reference/sqlite3/sqlite3stmt.xml
@@ -24,6 +24,26 @@
      <classname>SQLite3Stmt</classname>
     </ooclass>
 
+    <classsynopsisinfo role="comment">&Constants;</classsynopsisinfo>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="sqlite3stmt.constants.explain-mode-prepared">SQLite3Stmt::EXPLAIN_MODE_PREPARED</varname>
+     <initializer>0</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="sqlite3stmt.constants.explain-mode-explain">SQLite3Stmt::EXPLAIN_MODE_EXPLAIN</varname>
+     <initializer>1</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="sqlite3stmt.constants.explain-mode-explain-query-plan">SQLite3Stmt::EXPLAIN_MODE_EXPLAIN_QUERY_PLAN</varname>
+     <initializer>2</initializer>
+    </fieldsynopsis>
+
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.sqlite3stmt')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='SQLite3Stmt'])">
      <xi:fallback/>
@@ -36,6 +56,47 @@
 
   </section>
 
+<!-- {{{ SQLite3Stmt constants -->
+  <section xml:id="sqlite3stmt.constants">
+   &reftitle.constants;
+   <variablelist>
+
+    <varlistentry xml:id="sqlite3stmt.constants.explain-mode-prepared">
+     <term><constant>SQLite3Stmt::EXPLAIN_MODE_PREPARED</constant></term>
+     <listitem>
+      <para>
+       The statement operates in normal prepared statement mode (no <literal>EXPLAIN</literal>).
+       Available as of PHP 8.5.0.
+      </para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="sqlite3stmt.constants.explain-mode-explain">
+     <term><constant>SQLite3Stmt::EXPLAIN_MODE_EXPLAIN</constant></term>
+     <listitem>
+      <para>
+       The statement operates as if prefixed with <literal>EXPLAIN</literal>,
+       returning opcode information from the virtual machine.
+       Available as of PHP 8.5.0.
+      </para>
+     </listitem>
+    </varlistentry>
+
+    <varlistentry xml:id="sqlite3stmt.constants.explain-mode-explain-query-plan">
+     <term><constant>SQLite3Stmt::EXPLAIN_MODE_EXPLAIN_QUERY_PLAN</constant></term>
+     <listitem>
+      <para>
+       The statement operates as if prefixed with <literal>EXPLAIN QUERY PLAN</literal>,
+       returning high-level query plan information.
+       Available as of PHP 8.5.0.
+      </para>
+     </listitem>
+    </varlistentry>
+
+   </variablelist>
+  </section>
+<!-- }}} -->
+
  </partintro>
 
  &reference.sqlite3.entities.sqlite3stmt;
diff --git a/reference/sqlite3/versions.xml b/reference/sqlite3/versions.xml
index bf64ad3d6231..a9a0ccd3e983 100644
--- a/reference/sqlite3/versions.xml
+++ b/reference/sqlite3/versions.xml
@@ -32,6 +32,9 @@
  <function name="SQLite3Exception" from="PHP 8 &gt;= 8.3.0"/>
 
  <function name="SQLite3Stmt" from="PHP 5 &gt;= 5.3.0, PHP 7, PHP 8"/>
+ <function name="SQLite3Stmt::EXPLAIN_MODE_PREPARED" from="PHP 8 &gt;= 8.5.0"/>
+ <function name="SQLite3Stmt::EXPLAIN_MODE_EXPLAIN" from="PHP 8 &gt;= 8.5.0"/>
+ <function name="SQLite3Stmt::EXPLAIN_MODE_EXPLAIN_QUERY_PLAN" from="PHP 8 &gt;= 8.5.0"/>
  <function name="SQLite3Stmt::__construct" from="PHP 5 &gt;= 5.3.0, PHP 7, PHP 8"/>
  <function name="SQLite3Stmt::bindParam" from="PHP 5 &gt;= 5.3.0, PHP 7, PHP 8"/>
  <function name="SQLite3Stmt::bindValue" from="PHP 5 &gt;= 5.3.0, PHP 7, PHP 8"/>