Skip to content

[Sync-En] ext/pdo_sqlite: document the PHP 8.5 additions and behaviour changes (#5818) #1223

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

Open
lacatoire wants to merge 1 commit into
base: master
Choose a base branch
from
Open

[Sync-En] ext/pdo_sqlite: document the PHP 8.5 additions and behaviour changes (#5818) #1223

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
28 changes: 26 additions & 2 deletions reference/pdo/pdo/quote.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: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no Maintainer: Marqitos -->
<!-- EN-Revision: eff8e0d4dd463ae6bd387f304effeaf3d5ce44d5 Maintainer: PhilDaiguille Status: ready -->
<refentry xml:id="pdo.quote" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>PDO::quote</refname>
Expand Down Expand Up @@ -83,6 +82,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>
Al usar el controlador SQLite, ahora se lanza una <exceptionname>PDOException</exceptionname>
o se emite una advertencia, según el modo de error, si el
<parameter>string</parameter> contiene un byte nulo; anteriormente el
string era truncado silenciosamente en el byte nulo.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
Expand Down
10 changes: 5 additions & 5 deletions reference/pdo_sqlite/configure.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,18 +1,18 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 859713422861ee5d25d5e8504928a4af9ce198ad Maintainer: seros Status: ready -->
<!-- Reviewed: yes Maintainer: julionc -->
<!-- EN-Revision: eff8e0d4dd463ae6bd387f304effeaf3d5ce44d5 Maintainer: seros 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>
El controlador PDO_SQLITE PDO está habilitado por omisión. Para deshabilitarlo,
se puede usar <option role="configure">--without-pdo-sqlite[=DIR]</option>,
donde el parámetro opcional <literal>[=DIR]</literal> es el directorio base de instalación de sqlite.
A partir de PHP 7.4.0 se requiere <link xlink:href="&url.sqlite;">libsqlite</link> ≥ 3.5.0.
A partir de PHP 7.4.0 se requiere <link xlink:href="&url.sqlite;">libsqlite</link> ≥ 3.5.0,
y a partir de PHP 8.5.0 se requiere libsqlite ≥ 3.7.17.
Anteriormente, si libsqlite incluido podría haberse usado en su lugar, por omisión,
si <literal>[=DIR]</literal> era omitido.
</para>
</simpara>
<note>
<title>Configuración adicional en Windows a 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: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<!-- EN-Revision: eff8e0d4dd463ae6bd387f304effeaf3d5ce44d5 Maintainer: PhilDaiguille 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 clase 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>
Atributo de sentencia de solo lectura, recuperado con
<methodname>PDOStatement::getAttribute</methodname>, que es &true; si
la sentencia ha sido ejecutada y todavía tiene una fila pendiente, y &false;
en caso contrario.
Disponible a 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>
Atributo de sentencia que controla el modo de explicación, establecido con
<methodname>PDOStatement::setAttribute</methodname>. Los valores posibles son
<constant>Pdo\Sqlite::EXPLAIN_MODE_PREPARED</constant>,
<constant>Pdo\Sqlite::EXPLAIN_MODE_EXPLAIN</constant> y
<constant>Pdo\Sqlite::EXPLAIN_MODE_EXPLAIN_QUERY_PLAN</constant>.
Se lanza un <exceptionname>ValueError</exceptionname> si PHP ha sido compilado
con una versión de libsqlite anterior a 3.43.0.
Disponible a 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>
Valor para <constant>Pdo\Sqlite::ATTR_EXPLAIN_STATEMENT</constant>:
devuelve la sentencia tal como fue preparada (sin explicación).
Disponible a partir de PHP 8.5.0, compilado con 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>
Valor para <constant>Pdo\Sqlite::ATTR_EXPLAIN_STATEMENT</constant>:
devuelve los códigos de operación de la máquina virtual utilizada para ejecutar la sentencia
(equivalente al <literal>EXPLAIN</literal> de SQLite).
Disponible a partir de PHP 8.5.0, compilado con 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>
Valor para <constant>Pdo\Sqlite::ATTR_EXPLAIN_STATEMENT</constant>:
devuelve el plan de consulta (equivalente al
<literal>EXPLAIN QUERY PLAN</literal> de SQLite).
Disponible a partir de PHP 8.5.0, compilado con 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>
Atributo de conexión que configura el modo de transacción utilizado por
<methodname>PDO::beginTransaction</methodname>. Los valores posibles son
<constant>Pdo\Sqlite::TRANSACTION_MODE_DEFERRED</constant>,
<constant>Pdo\Sqlite::TRANSACTION_MODE_IMMEDIATE</constant> y
<constant>Pdo\Sqlite::TRANSACTION_MODE_EXCLUSIVE</constant>.
Disponible a 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>
Valor para <constant>Pdo\Sqlite::ATTR_TRANSACTION_MODE</constant>:
utiliza el modo de transacción DEFERRED de SQLite (el predeterminado).
Disponible a 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>
Valor para <constant>Pdo\Sqlite::ATTR_TRANSACTION_MODE</constant>:
utiliza el modo de transacción IMMEDIATE de SQLite.
Disponible a 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>
Valor para <constant>Pdo\Sqlite::ATTR_TRANSACTION_MODE</constant>:
utiliza el modo de transacción EXCLUSIVE de SQLite.
Disponible a 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>
Valor de retorno de una retrollamada de autorización establecida con
<methodname>Pdo\Sqlite::setAuthorizer</methodname>, que permite la acción.
Disponible a 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>
Valor de retorno de una retrollamada de autorización establecida con
<methodname>Pdo\Sqlite::setAuthorizer</methodname>, que deniega la acción.
Disponible a 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>
Valor de retorno de una retrollamada de autorización establecida con
<methodname>Pdo\Sqlite::setAuthorizer</methodname>, que sustituye un valor &null;
por la columna que habría sido leída.
Disponible a 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>
Se añadieron las 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> y
<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: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<!-- EN-Revision: eff8e0d4dd463ae6bd387f304effeaf3d5ce44d5 Maintainer: PhilDaiguille 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>
Se lanza un <exceptionname>TypeError</exceptionname> si la
<parameter>callback</parameter> no devuelve un valor de tipo <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>
Ahora se lanza un <exceptionname>TypeError</exceptionname> si la
<parameter>callback</parameter> no devuelve un valor de tipo <type>int</type>;
anteriormente el valor devuelto era convertido a <type>int</type>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

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