[DOC-CVS] [doc-en] master: ext/pdo: Document PHP 8.5.0 deprecations in PDO constants and methods (#5635)

Author: Jordi Kroon (jordikroon)
Committer: GitHub (web-flow)
Pusher: jordikroon
Date: 2026-06-25T09:23:20+02:00

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

ext/pdo: Document PHP 8.5.0 deprecations in PDO constants and methods (#5635)

Changed paths:
  M  reference/pdo/constants.xml
  M  reference/pdo_firebird/constants.xml
  M  reference/pdo_mysql/constants.xml
  M  reference/pdo_odbc/constants.xml
  M  reference/pdo_sqlite/pdo_overloaded/sqliteCreateAggregate.xml
  M  reference/pdo_sqlite/pdo_overloaded/sqliteCreateCollation.xml
  M  reference/pdo_sqlite/pdo_overloaded/sqliteCreateFunction.xml


Diff:

diff --git a/reference/pdo/constants.xml b/reference/pdo/constants.xml
index 285a16ffe336..14d9a5d76247 100644
--- a/reference/pdo/constants.xml
+++ b/reference/pdo/constants.xml
@@ -736,6 +736,12 @@
      (<type>int</type>)
     </term>
     <listitem>
+     <warning>
+      <simpara>
+       This constant has been <emphasis>DEPRECATED</emphasis> as of PHP 8.5.0.
+       Use <constant>Pdo\Sqlite::DETERMINISTIC</constant> instead.
+      </simpara>
+     </warning>
      <simpara>
        Specifies that a function created with <methodname>PDO::sqliteCreateFunction</methodname>
        is deterministic, i.e. it always returns the same result given the same inputs within
diff --git a/reference/pdo_firebird/constants.xml b/reference/pdo_firebird/constants.xml
index 7d9dae9cdaf5..06edcdc9db5d 100644
--- a/reference/pdo_firebird/constants.xml
+++ b/reference/pdo_firebird/constants.xml
@@ -3,6 +3,13 @@
 <section xml:id="ref.pdo-firebird.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
  &pdo.driver-constants;
+ <warning>
+  <simpara>
+   The constants listed below have been <emphasis>DEPRECATED</emphasis>
+   as of PHP 8.5.0. Use the corresponding <classname>Pdo\Firebird</classname>
+   constants instead.
+  </simpara>
+ </warning>
  <variablelist>
   <varlistentry xml:id="pdo.constants.fb-attr-date-format">
    <term>
@@ -10,9 +17,9 @@
      (<type>int</type>)
    </term>
    <listitem>
-    <para>
+    <simpara>
      &Alias; <constant>Pdo\Firebird::ATTR_DATE_FORMAT</constant>.
-    </para>
+    </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="pdo.constants.fb-attr-time-format">
@@ -21,9 +28,9 @@
      (<type>int</type>)
    </term>
    <listitem>
-    <para>
+    <simpara>
      &Alias; <constant>Pdo\Firebird::ATTR_TIME_FORMAT</constant>.
-    </para>
+    </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="pdo.constants.fb-attr-timestamp-format">
@@ -32,9 +39,9 @@
      (<type>int</type>)
    </term>
    <listitem>
-    <para>
+    <simpara>
      &Alias; <constant>Pdo\Firebird::ATTR_TIMESTAMP_FORMAT</constant>.
-    </para>
+    </simpara>
    </listitem>
   </varlistentry>
  </variablelist>
diff --git a/reference/pdo_mysql/constants.xml b/reference/pdo_mysql/constants.xml
index 935bed3eed19..f85238051bf9 100644
--- a/reference/pdo_mysql/constants.xml
+++ b/reference/pdo_mysql/constants.xml
@@ -3,6 +3,13 @@
 <section xml:id="ref.pdo-mysql.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
  &pdo.driver-constants;
+ <warning>
+  <simpara>
+   The constants listed below have been <emphasis>DEPRECATED</emphasis>
+   as of PHP 8.5.0. Use the corresponding <classname>Pdo\Mysql</classname>
+   constants instead.
+  </simpara>
+ </warning>
  <variablelist>
   <varlistentry xml:id="pdo.constants.mysql-attr-use-buffered-query">
    <term>
diff --git a/reference/pdo_odbc/constants.xml b/reference/pdo_odbc/constants.xml
index e62c7f5d3a55..e9af8e484f14 100644
--- a/reference/pdo_odbc/constants.xml
+++ b/reference/pdo_odbc/constants.xml
@@ -11,11 +11,22 @@
     (<type>string</type>)
    </term>
    <listitem>
-    <para>
-
-    </para>
+    <simpara>
+     Describes the ODBC library linked against the PDO_ODBC extension.
+     Possible values include <literal>unixODBC</literal>,
+     <literal>iODBC</literal>, or <literal>generic</literal>.
+    </simpara>
    </listitem>
   </varlistentry>
+ </variablelist>
+ <warning>
+  <simpara>
+   The constants listed below have been <emphasis>DEPRECATED</emphasis>
+   as of PHP 8.5.0. Use the corresponding <classname>Pdo\Odbc</classname>
+   constants instead.
+  </simpara>
+ </warning>
+ <variablelist>
   <varlistentry xml:id="pdo.constants.odbc-attr-use-cursor-library">
    <term>
     <constant>PDO::ODBC_ATTR_USE_CURSOR_LIBRARY</constant>
diff --git a/reference/pdo_sqlite/pdo_overloaded/sqliteCreateAggregate.xml b/reference/pdo_sqlite/pdo_overloaded/sqliteCreateAggregate.xml
index 3913996ec2c0..3fe7619c1cdd 100644
--- a/reference/pdo_sqlite/pdo_overloaded/sqliteCreateAggregate.xml
+++ b/reference/pdo_sqlite/pdo_overloaded/sqliteCreateAggregate.xml
@@ -8,6 +8,10 @@
   </refpurpose>
  </refnamediv>
 
+ <refsynopsisdiv>
+  &warn.deprecated.function-8-5-0;
+ </refsynopsisdiv>
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
diff --git a/reference/pdo_sqlite/pdo_overloaded/sqliteCreateCollation.xml b/reference/pdo_sqlite/pdo_overloaded/sqliteCreateCollation.xml
index 260026c8b342..2feeedc13929 100644
--- a/reference/pdo_sqlite/pdo_overloaded/sqliteCreateCollation.xml
+++ b/reference/pdo_sqlite/pdo_overloaded/sqliteCreateCollation.xml
@@ -8,6 +8,10 @@
   </refpurpose>
  </refnamediv>
 
+ <refsynopsisdiv>
+  &warn.deprecated.function-8-5-0;
+ </refsynopsisdiv>
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
diff --git a/reference/pdo_sqlite/pdo_overloaded/sqliteCreateFunction.xml b/reference/pdo_sqlite/pdo_overloaded/sqliteCreateFunction.xml
index 676f797b843e..00f477a1a72d 100644
--- a/reference/pdo_sqlite/pdo_overloaded/sqliteCreateFunction.xml
+++ b/reference/pdo_sqlite/pdo_overloaded/sqliteCreateFunction.xml
@@ -8,6 +8,10 @@
   </refpurpose>
  </refnamediv>
 
+ <refsynopsisdiv>
+  &warn.deprecated.function-8-5-0;
+ </refsynopsisdiv>
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>