Skip to content

[Sync-En] ext/pdo_sqlite: document the PHP 8.5 additions and behaviour changes #3470

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
lacatoire merged 1 commit into from
Sep 1, 2026
Merged

[Sync-En] ext/pdo_sqlite: document the PHP 8.5 additions and behaviour changes #3470

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 26 additions & 1 deletion reference/pdo/pdo/quote.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: lacatoire Status: ready -->
<!-- EN-Revision: eff8e0d4dd463ae6bd387f304effeaf3d5ce44d5 Maintainer: lacatoire Status: ready -->
<refentry xml:id="pdo.quote" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>PDO::quote</refname>
Expand Down Expand Up @@ -83,6 +83,31 @@
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Lors de l'utilisation du pilote SQLite, une <exceptionname>PDOException</exceptionname>
est désormais lancée ou une alerte est émise, selon le mode d'erreur, si la
chaîne <parameter>string</parameter> contient un octet nul ; auparavant, la
chaîne était silencieusement tronquée au niveau de l'octet nul.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
Expand Down
11 changes: 5 additions & 6 deletions reference/pdo_sqlite/configure.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,19 +1,18 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 859713422861ee5d25d5e8504928a4af9ce198ad Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<!-- EN-Revision: eff8e0d4dd463ae6bd387f304effeaf3d5ce44d5 Maintainer: yannick Status: ready -->

<section xml:id="ref.pdo-sqlite.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.install;
<para>
<simpara>
Le driver PDO PDO_SQLITE est actif par défaut. Pour le désactiver,
utiliser l'option de compilation
<option role="configure">--without-pdo-sqlite[=DIR]</option>, où
<literal>[=DIR]</literal> (optionnel) représente le chemin vers le
dossier d'installation de base de sqlite.
À partir de PHP 7.4.0 <link xlink:href="&url.sqlite;">libsqlite</link> ≥ 3.5.0 est requis.
À partir de PHP 7.4.0 <link xlink:href="&url.sqlite;">libsqlite</link> ≥ 3.5.0 est requis,
et à partir de PHP 8.5.0 libsqlite ≥ 3.7.17 est requis.
Auparavant, la libsqlite intégrée pouvait être utilisée à la place, et était par défaut, si <literal>[=DIR]</literal> était omis.
</para>
</simpara>
<note>
<title>Installation supplémentaire sur Windows à partir de PHP 7.4.0</title>
<para>
Expand Down
242 changes: 240 additions & 2 deletions reference/pdo_sqlite/pdo-sqlite.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ae7db14ea8cb8f3041e114f0ef865d86a95f72d6 Maintainer: Fan2Shrek Status: ready -->
<!-- Reviewed: yes -->
<!-- EN-Revision: eff8e0d4dd463ae6bd387f304effeaf3d5ce44d5 Maintainer: Fan2Shrek Status: ready -->
<reference xml:id="class.pdo-sqlite" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>La classe Pdo\Sqlite</title>
<titleabbrev>Pdo\Sqlite</titleabbrev>
Expand Down Expand Up @@ -100,6 +99,78 @@
<type>int</type>
<varname linkend="pdo-sqlite.constants.attr-extended-result-codes">Pdo\Sqlite::ATTR_EXTENDED_RESULT_CODES</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="pdo-sqlite.constants.attr-busy-statement">Pdo\Sqlite::ATTR_BUSY_STATEMENT</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="pdo-sqlite.constants.attr-explain-statement">Pdo\Sqlite::ATTR_EXPLAIN_STATEMENT</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="pdo-sqlite.constants.explain-mode-prepared">Pdo\Sqlite::EXPLAIN_MODE_PREPARED</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="pdo-sqlite.constants.explain-mode-explain">Pdo\Sqlite::EXPLAIN_MODE_EXPLAIN</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="pdo-sqlite.constants.explain-mode-explain-query-plan">Pdo\Sqlite::EXPLAIN_MODE_EXPLAIN_QUERY_PLAN</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="pdo-sqlite.constants.attr-transaction-mode">Pdo\Sqlite::ATTR_TRANSACTION_MODE</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="pdo-sqlite.constants.transaction-mode-deferred">Pdo\Sqlite::TRANSACTION_MODE_DEFERRED</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="pdo-sqlite.constants.transaction-mode-immediate">Pdo\Sqlite::TRANSACTION_MODE_IMMEDIATE</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="pdo-sqlite.constants.transaction-mode-exclusive">Pdo\Sqlite::TRANSACTION_MODE_EXCLUSIVE</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="pdo-sqlite.constants.ok">Pdo\Sqlite::OK</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="pdo-sqlite.constants.deny">Pdo\Sqlite::DENY</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="pdo-sqlite.constants.ignore">Pdo\Sqlite::IGNORE</varname>
</fieldsynopsis>

<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo-sqlite')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Pdo\\Sqlite'])">
Expand Down Expand Up @@ -170,8 +241,175 @@
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-sqlite.constants.attr-busy-statement">
<term><constant>Pdo\Sqlite::ATTR_BUSY_STATEMENT</constant></term>
<listitem>
<simpara>
Un attribut de requête préparée en lecture seule, récupéré avec
<methodname>PDOStatement::getAttribute</methodname>, qui vaut &true; si
la requête préparée a été exécutée et possède encore une ligne en attente,
et &false; sinon.
Disponible à partir de PHP 8.5.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-sqlite.constants.attr-explain-statement">
<term><constant>Pdo\Sqlite::ATTR_EXPLAIN_STATEMENT</constant></term>
<listitem>
<simpara>
Un attribut de requête préparée contrôlant le mode d'explication, défini avec
<methodname>PDOStatement::setAttribute</methodname>. Les valeurs possibles sont
<constant>Pdo\Sqlite::EXPLAIN_MODE_PREPARED</constant>,
<constant>Pdo\Sqlite::EXPLAIN_MODE_EXPLAIN</constant> et
<constant>Pdo\Sqlite::EXPLAIN_MODE_EXPLAIN_QUERY_PLAN</constant>.
Une <exceptionname>ValueError</exceptionname> est lancée si PHP a été compilé
avec une libsqlite antérieure à 3.43.0.
Disponible à partir de PHP 8.5.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-sqlite.constants.explain-mode-prepared">
<term><constant>Pdo\Sqlite::EXPLAIN_MODE_PREPARED</constant></term>
<listitem>
<simpara>
Valeur pour <constant>Pdo\Sqlite::ATTR_EXPLAIN_STATEMENT</constant> :
retourne la requête telle qu'elle a été préparée (aucune explication).
Disponible à partir de PHP 8.5.0, lorsque PHP est compilé avec une libsqlite &gt;= 3.43.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-sqlite.constants.explain-mode-explain">
<term><constant>Pdo\Sqlite::EXPLAIN_MODE_EXPLAIN</constant></term>
<listitem>
<simpara>
Valeur pour <constant>Pdo\Sqlite::ATTR_EXPLAIN_STATEMENT</constant> :
retourne les opcodes de la machine virtuelle utilisée pour exécuter la requête
(équivalent à l'instruction <literal>EXPLAIN</literal> de SQLite).
Disponible à partir de PHP 8.5.0, lorsque PHP est compilé avec une libsqlite &gt;= 3.43.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-sqlite.constants.explain-mode-explain-query-plan">
<term><constant>Pdo\Sqlite::EXPLAIN_MODE_EXPLAIN_QUERY_PLAN</constant></term>
<listitem>
<simpara>
Valeur pour <constant>Pdo\Sqlite::ATTR_EXPLAIN_STATEMENT</constant> :
retourne le plan d'exécution de la requête (équivalent à l'instruction
<literal>EXPLAIN QUERY PLAN</literal> de SQLite).
Disponible à partir de PHP 8.5.0, lorsque PHP est compilé avec une libsqlite &gt;= 3.43.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-sqlite.constants.attr-transaction-mode">
<term><constant>Pdo\Sqlite::ATTR_TRANSACTION_MODE</constant></term>
<listitem>
<simpara>
Un attribut de connexion configurant le mode de transaction utilisé par
<methodname>PDO::beginTransaction</methodname>. Les valeurs possibles sont
<constant>Pdo\Sqlite::TRANSACTION_MODE_DEFERRED</constant>,
<constant>Pdo\Sqlite::TRANSACTION_MODE_IMMEDIATE</constant> et
<constant>Pdo\Sqlite::TRANSACTION_MODE_EXCLUSIVE</constant>.
Disponible à partir de PHP 8.5.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-sqlite.constants.transaction-mode-deferred">
<term><constant>Pdo\Sqlite::TRANSACTION_MODE_DEFERRED</constant></term>
<listitem>
<simpara>
Valeur pour <constant>Pdo\Sqlite::ATTR_TRANSACTION_MODE</constant> :
utilise le mode de transaction DEFERRED de SQLite (le mode par défaut).
Disponible à partir de PHP 8.5.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-sqlite.constants.transaction-mode-immediate">
<term><constant>Pdo\Sqlite::TRANSACTION_MODE_IMMEDIATE</constant></term>
<listitem>
<simpara>
Valeur pour <constant>Pdo\Sqlite::ATTR_TRANSACTION_MODE</constant> :
utilise le mode de transaction IMMEDIATE de SQLite.
Disponible à partir de PHP 8.5.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-sqlite.constants.transaction-mode-exclusive">
<term><constant>Pdo\Sqlite::TRANSACTION_MODE_EXCLUSIVE</constant></term>
<listitem>
<simpara>
Valeur pour <constant>Pdo\Sqlite::ATTR_TRANSACTION_MODE</constant> :
utilise le mode de transaction EXCLUSIVE de SQLite.
Disponible à partir de PHP 8.5.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-sqlite.constants.ok">
<term><constant>Pdo\Sqlite::OK</constant></term>
<listitem>
<simpara>
Valeur de retour d'une fonction de rappel d'autorisation définie avec
<methodname>Pdo\Sqlite::setAuthorizer</methodname>, autorisant l'action.
Disponible à partir de PHP 8.5.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-sqlite.constants.deny">
<term><constant>Pdo\Sqlite::DENY</constant></term>
<listitem>
<simpara>
Valeur de retour d'une fonction de rappel d'autorisation définie avec
<methodname>Pdo\Sqlite::setAuthorizer</methodname>, refusant l'action.
Disponible à partir de PHP 8.5.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-sqlite.constants.ignore">
<term><constant>Pdo\Sqlite::IGNORE</constant></term>
<listitem>
<simpara>
Valeur de retour d'une fonction de rappel d'autorisation définie avec
<methodname>Pdo\Sqlite::setAuthorizer</methodname>, substituant une valeur
&null; à la colonne qui aurait été lue.
Disponible à partir de PHP 8.5.0.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</section>

<section role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Ajout des constantes <constant>Pdo\Sqlite::ATTR_BUSY_STATEMENT</constant>,
<constant>Pdo\Sqlite::ATTR_EXPLAIN_STATEMENT</constant>,
<constant>Pdo\Sqlite::EXPLAIN_MODE_PREPARED</constant>,
<constant>Pdo\Sqlite::EXPLAIN_MODE_EXPLAIN</constant>,
<constant>Pdo\Sqlite::EXPLAIN_MODE_EXPLAIN_QUERY_PLAN</constant>,
<constant>Pdo\Sqlite::ATTR_TRANSACTION_MODE</constant>,
<constant>Pdo\Sqlite::TRANSACTION_MODE_DEFERRED</constant>,
<constant>Pdo\Sqlite::TRANSACTION_MODE_IMMEDIATE</constant>,
<constant>Pdo\Sqlite::TRANSACTION_MODE_EXCLUSIVE</constant>,
<constant>Pdo\Sqlite::OK</constant>,
<constant>Pdo\Sqlite::DENY</constant> et
<constant>Pdo\Sqlite::IGNORE</constant>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</section>

</partintro>

&reference.pdo-sqlite.pdo.entities.sqlite;
Expand Down
35 changes: 33 additions & 2 deletions reference/pdo_sqlite/pdo/sqlite/createcollation.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 51610360d58ed09bc9d1312f419057c0d1d1a998 Maintainer: Fan2Shrek Status: ready -->
<!-- Reviewed: yes -->
<!-- EN-Revision: eff8e0d4dd463ae6bd387f304effeaf3d5ce44d5 Maintainer: Fan2Shrek Status: ready -->
<refentry xml:id="pdo-sqlite.createcollation" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>Pdo\Sqlite::createCollation</refname>
Expand Down Expand Up @@ -64,6 +63,38 @@
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Une <exceptionname>TypeError</exceptionname> est lancée si
<parameter>callback</parameter> ne retourne pas un <type>int</type>.
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Une <exceptionname>TypeError</exceptionname> est désormais lancée si
<parameter>callback</parameter> ne retourne pas un <type>int</type> ;
auparavant, la valeur retournée était convertie en <type>int</type>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<example>
Expand Down
Loading
Loading