Skip to content

[Sync-En] pdo_sqlite, intl, zlib: file: URI DSN, grapheme_strstr example, PHP 8.5 zlib changes #1555

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
julionc merged 1 commit into from
Nov 7, 2026
Merged

[Sync-En] pdo_sqlite, intl, zlib: file: URI DSN, grapheme_strstr example, PHP 8.5 zlib changes #1555

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
10 changes: 6 additions & 4 deletions reference/filesystem/functions/flock.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: f3112c43e303fcd63c0df89798b45bfef9d49e15 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 0baba6599fa96a354d01ce3592bee5d2d355e1ba Maintainer: PhilDaiguille Status: ready -->
<refentry xml:id="function.flock" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>flock</refname>
Expand All @@ -26,7 +26,7 @@
<para>
PHP soporta una forma portátil de bloquear ficheros completos de manera consultiva
(lo que significa que todos los programas que acceden deben usar el mismo método
de bloqueo o no funcionará). Por omisión, esta función bloqueará hasta que se
de bloqueo o no funcionará). Por defecto, esta función bloqueará hasta que se
adquiera el bloqueo solicitado; esto puede controlarse con la opción
<constant>LOCK_NB</constant> documentada más abajo.
</para>
Expand Down Expand Up @@ -166,11 +166,13 @@ fclose($fp);
</para>
</note>
<note>
<para>
<simpara>
Solo puede usarse en punteros a ficheros devueltos por <function>fopen</function>
para ficheros locales, o punteros a ficheros que apunten a flujos en espacio
de usuario que implementen el método <function>streamWrapper::stream_lock</function>.
</para>
A partir de PHP 8.5.0, también puede usarse en punteros a ficheros devueltos por
<function>gzopen</function>.
</simpara>
</note>
<warning>
<para>
Expand Down
6 changes: 3 additions & 3 deletions reference/intl/grapheme/grapheme-strstr.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 9a8c593c09cf7d84085989e42f3b2b23536279db Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 499af2ce44d003040a0e95878c596af5f57c8547 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<!-- CREDITS: DAnnebicque -->

<refentry xml:id="function.grapheme-strstr" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>grapheme_strstr</refname>
<refpurpose>Retorna la parte de una cadena a partir de una ocurrencia, insensible a mayúsculas/minúsculas</refpurpose>
<refpurpose>Retorna la parte de una cadena a partir de una ocurrencia, sensible a mayúsculas/minúsculas</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
Expand Down Expand Up @@ -101,7 +101,7 @@
$char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) forma de normalización "D"
$char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) forma de normalización "D"

print urlencode(grapheme_stristr( $char_a_ring_nfd . $char_o_diaeresis_nfd . $char_a_ring_nfd, $char_o_diaeresis_nfd));
print urlencode(grapheme_strstr( $char_a_ring_nfd . $char_o_diaeresis_nfd . $char_a_ring_nfd, $char_o_diaeresis_nfd));

?>
]]>
Expand Down
52 changes: 48 additions & 4 deletions reference/pdo_sqlite/reference.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 3c1bec9d700807df36994cf368ba291214cd424d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 0075c0fad0709b16d96ebbbecd69191fe9e835f1 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->

<reference xml:id="ref.pdo-sqlite" xmlns="http://docbook.org/ns/docbook">
<reference xml:id="ref.pdo-sqlite" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="bundledexternal" ?>
<title>Funciones del controlador PDO SQLite (PDO_SQLITE)</title>
<titleabbrev>Controlador PDO SQLite</titleabbrev>
Expand All @@ -12,8 +12,8 @@
<section xml:id="ref.pdo-sqlite.intro">
&reftitle.intro;
<para>
PDO_SQLITE es un controlador que implementa la <link linkend="intro.pdo">PHP
Data Objects (PDO)</link> para
PDO_SQLITE es un controlador que implementa la <link linkend="intro.pdo">interfaz
PHP Data Objects (PDO)</link> para
permitir el acceso de PHP a las bases de datos SQLite 3.
</para>
<note>
Expand Down Expand Up @@ -57,6 +57,28 @@
<literal>:memory:</literal> al prefijo DSN.
</para>
</listitem>
<listitem>
<simpara>
Un DSN que comienza por <literal>file:</literal> después del prefijo
DSN se pasa sin modificar a SQLite como un
<link xlink:href="&url.sqlite;uri.html">nombre de fichero URI</link>.
Sus parámetros de consulta establecen opciones, por ejemplo
<literal>mode=ro</literal> abre la base de datos en modo de solo lectura,
y los parámetros desconocidos se ignoran.
Los nombres de fichero URI no están disponibles si
<link linkend="ini.open-basedir">open_basedir</link> está establecido.
</simpara>
<caution>
<simpara>
Un nombre de fichero URI puede designar cualquier fichero,
independientemente del final del DSN; por ejemplo,
<literal>sqlite:file:/var/www/data.php?x=.db</literal> abre
<filename>/var/www/data.php</filename>.
Por lo tanto, no debería permitirse que un DSN construido a partir
de datos del usuario comience por <literal>file:</literal>.
</simpara>
</caution>
</listitem>
<listitem>
<para>
Si el DSN contiene solo el prefijo DSN, se creará una base de datos
Expand All @@ -71,6 +93,27 @@
</variablelist>
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.1.0</entry>
<entry>
Se añadió soporte para los nombres de fichero URI <literal>file:</literal>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
Expand All @@ -82,6 +125,7 @@
<programlisting>
<![CDATA[
sqlite:/opt/databases/mydb.sq3
sqlite:file:/opt/databases/mydb.sq3?mode=ro
sqlite::memory:
sqlite:
]]>
Expand Down
18 changes: 13 additions & 5 deletions reference/zlib/functions/gzfile.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: aa120f36c5762e99f9ee121d8caf910e0a67121e Maintainer: jpberdejo Status: ready -->
<!-- EN-Revision: 0baba6599fa96a354d01ce3592bee5d2d355e1ba Maintainer: jpberdejo Status: ready -->
<refentry xml:id="function.gzfile" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>gzfile</refname>
<refpurpose>Lee un archivo gz completo en una matriz</refpurpose>
<refpurpose>Lee un archivo gz completo en un array</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
Expand All @@ -14,8 +14,8 @@
<methodparam choice="opt"><type>bool</type><parameter>use_include_path</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>
Está función es identica a <function>readgzfile</function>, excepto que
retorna el archivo en una matriz.
Esta función es idéntica a <function>readgzfile</function>, excepto que
retorna el archivo en un array.
</para>
</refsect1>
<refsect1 role="parameters">
Expand Down Expand Up @@ -44,7 +44,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Una matriz que contiene el archivo, una línea por celda, incluidas líneas vacías, y con líneas nuevas aún unidas, &return.falseforfailure;.
Un array que contiene el archivo, una línea por celda, incluidas las líneas vacías, y con los caracteres de nueva línea aún incluidos, &return.falseforfailure;.
</para>
</refsect1>

Expand All @@ -66,6 +66,14 @@
Anteriormente, era de tipo <type>int</type>.
</entry>
</row>
<row>
<entry>8.5.0</entry>
<entry>
Ahora se utiliza el contexto de flujo predeterminado (véase
<function>stream_context_set_default</function>) al abrir el fichero.
Anteriormente, se ignoraba.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
Expand Down
21 changes: 18 additions & 3 deletions reference/zlib/functions/gzopen.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: aa120f36c5762e99f9ee121d8caf910e0a67121e Maintainer: jpberdejo Status: ready -->
<!-- EN-Revision: 0baba6599fa96a354d01ce3592bee5d2d355e1ba Maintainer: jpberdejo Status: ready -->
<refentry xml:id="function.gzopen" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>gzopen</refname>
Expand Down Expand Up @@ -41,7 +41,7 @@
<para>
Como en <function>fopen</function> (<literal>rb</literal> o
<literal>wb</literal>) pero también puede incluir un nivel
de compresión (<literal>wb9</literal>) u una estrategia:
de compresión (<literal>wb9</literal>) o una estrategia:
<literal>f</literal> para datos filtrados como en
<literal>wb6f</literal>, <literal>h</literal> para
<literal>compresión Huffman solamente</literal> como en
Expand All @@ -67,7 +67,7 @@
&reftitle.returnvalues;
<para>
Retorna un apuntador hacia el archivo abierto, después de eso, cualquier
cosa que se lea desde este descriptor de archivo sera descomprimido
cosa que se lea desde este descriptor de archivo será descomprimido
de forma transparente y lo que se escriba será comprimido.
</para>
<para>
Expand All @@ -92,6 +92,21 @@
Anteriormente, era de tipo <type>int</type>.
</entry>
</row>
<row>
<entry>8.5.0</entry>
<entry>
Ahora se utiliza el contexto de flujo predeterminado (véase
<function>stream_context_set_default</function>) al abrir el fichero.
Anteriormente, se ignoraba.
</entry>
</row>
<row>
<entry>8.5.0</entry>
<entry>
<function>flock</function> ahora puede usarse en el puntero a fichero devuelto.
Anteriormente, siempre devolvía &false;.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
Expand Down
10 changes: 9 additions & 1 deletion reference/zlib/functions/readgzfile.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: aa120f36c5762e99f9ee121d8caf910e0a67121e Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 0baba6599fa96a354d01ce3592bee5d2d355e1ba Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->

<refentry xml:id="function.readgzfile" xmlns="http://docbook.org/ns/docbook">
Expand Down Expand Up @@ -82,6 +82,14 @@
Anteriormente, era de tipo <type>int</type>.
</entry>
</row>
<row>
<entry>8.5.0</entry>
<entry>
Ahora se utiliza el contexto de flujo predeterminado (véase
<function>stream_context_set_default</function>) al abrir el fichero.
Anteriormente, se ignoraba.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
Expand Down
Loading