From 47a9d38f6fcb370e9b80c10aac53a3037d92c5e1 Mon Sep 17 00:00:00 2001 From: Louis-Arnaud Date: Mon, 7 Sep 2026 10:12:50 +0200 Subject: [PATCH] [Sync-En] ext/sqlite3, ext/sockets: document the PHP 8.5 additions --- reference/sockets/constants.xml | 198 ++++++++++++++++++- reference/sqlite3/sqlite3stmt.xml | 89 +++++++-- reference/sqlite3/sqlite3stmt/busy.xml | 87 ++++++++ reference/sqlite3/sqlite3stmt/explain.xml | 66 +++++++ reference/sqlite3/sqlite3stmt/setexplain.xml | 84 ++++++++ 5 files changed, 512 insertions(+), 12 deletions(-) create mode 100644 reference/sqlite3/sqlite3stmt/busy.xml create mode 100644 reference/sqlite3/sqlite3stmt/explain.xml create mode 100644 reference/sqlite3/sqlite3stmt/setexplain.xml diff --git a/reference/sockets/constants.xml b/reference/sockets/constants.xml index 5dcdafb75a..e89708a57c 100644 --- a/reference/sockets/constants.xml +++ b/reference/sockets/constants.xml @@ -1,5 +1,5 @@ - + &reftitle.constants; @@ -3147,6 +3147,202 @@ + + + SHUT_RD + (int) + + + + Desactiva las operaciones de recepción posteriores sobre el socket. + Se utiliza con socket_shutdown. + Disponible a partir de PHP 8.5.0. + + + + + + SHUT_WR + (int) + + + + Desactiva las operaciones de envío posteriores sobre el socket. + Se utiliza con socket_shutdown. + Disponible a partir de PHP 8.5.0. + + + + + + SHUT_RDWR + (int) + + + + Desactiva las operaciones de envío y de recepción posteriores sobre el socket. + Se utiliza con socket_shutdown. + Disponible a partir de PHP 8.5.0. + + + + + + UDP_SEGMENT + (int) + + + + Define el tamaño máximo de los segmentos UDP GSO (Generic Segmentation + Offload), lo que permite enviar varios datagramas en una sola llamada al + sistema. + Disponible únicamente en Linux. + Disponible a partir de PHP 8.5.0. + + + + + + SO_BUSY_POLL + (int) + + + + Define el tiempo aproximado, en microsegundos, de espera activa durante una + recepción bloqueante cuando no hay datos. Esto reduce la latencia a costa + de consumo de CPU. + Disponible únicamente en Linux. + Disponible a partir de PHP 8.5.0. + + + + + + IP_BINDANY + (int) + + + + Permite asociar un socket a cualquier dirección, aunque no sea local. + Disponible únicamente en FreeBSD, NetBSD y OpenBSD. + Disponible a partir de PHP 8.5.0. + + + + + + TCP_FUNCTION_BLK + (int) + + + + Selecciona la pila TCP (bloque de funciones) utilizada por el socket. Con + socket_set_option, el valor es el nombre de la pila en + forma de string; socket_get_option + devuelve un array con las claves function_set_name y + pcbcnt. + Disponible únicamente en FreeBSD. + Disponible a partir de PHP 8.5.0. + + + + + + TCP_FUNCTION_ALIAS + (int) + + + + Obtiene el alias de la pila TCP utilizada por el socket, en forma de un + array con las claves function_set_name y + pcbcnt. + Disponible únicamente en FreeBSD. + Disponible a partir de PHP 8.5.0. + + + + + + TCP_REUSPORT_LB_NUMA + (int) + + + + Controla la afinidad de dominio NUMA para la reutilización de puerto con + balanceo de carga. + Disponible únicamente en FreeBSD. + Disponible a partir de PHP 8.5.0. + + + + + + TCP_REUSPORT_LB_NUMA_NODOM + (int) + + + + Valor de la constante TCP_REUSPORT_LB_NUMA que indica + la ausencia de afinidad de dominio NUMA. + Disponible únicamente en FreeBSD. + Disponible a partir de PHP 8.5.0. + + + + + + TCP_REUSPORT_LB_NUMA_CURDOM + (int) + + + + Valor de la constante TCP_REUSPORT_LB_NUMA que indica + una afinidad con el dominio NUMA actual. + Disponible únicamente en FreeBSD. + Disponible a partir de PHP 8.5.0. + + + + + + TCP_BBR_ALGORITHM + (int) + + + + Opción de socket relacionada con el algoritmo de control de congestión BBR + (Bottleneck Bandwidth and Round-trip propagation time). + Disponible únicamente en FreeBSD. + Disponible a partir de PHP 8.5.0. + + + + + + IPPROTO_ICMP + (int) + + + + Número de protocolo ICMP (Internet Control Message Protocol), utilizado al + crear sockets sin procesar. + Disponible a partir de PHP 8.5.0. + + + + + + IPPROTO_ICMPV6 + (int) + + + + Número de protocolo ICMPv6 (Internet Control Message Protocol version 6), + utilizado al crear sockets IPv6 sin procesar. + Disponible a partir de PHP 8.5.0. + + + diff --git a/reference/sqlite3/sqlite3stmt.xml b/reference/sqlite3/sqlite3stmt.xml index bacc43feb0..c9b72d961b 100644 --- a/reference/sqlite3/sqlite3stmt.xml +++ b/reference/sqlite3/sqlite3stmt.xml @@ -1,5 +1,5 @@ - + La clase <classname>SQLite3Stmt</classname> @@ -10,10 +10,14 @@
&reftitle.intro; - - La clase que representa los comandos preparados - para una base de datos SQLite3. - + + La clase que gestiona los comandos preparados para la extensión SQLite 3. + Las instancias se obtienen mediante + SQLite3::prepare. La llamada a + SQLite3Stmt::execute ejecuta la consulta y + devuelve un SQLite3Result para los conjuntos de + resultados. +
@@ -26,18 +30,81 @@ SQLite3Stmt + &Constants; + + public + const + int + SQLite3Stmt::EXPLAIN_MODE_PREPARED + 0 + + + public + const + int + SQLite3Stmt::EXPLAIN_MODE_EXPLAIN + 1 + + + public + const + int + SQLite3Stmt::EXPLAIN_MODE_EXPLAIN_QUERY_PLAN + 2 + + &Methods; - - - - - - + + + +
+ &reftitle.constants; + + + + SQLite3Stmt::EXPLAIN_MODE_PREPARED + + + El comando funciona en modo comando preparado normal (sin + EXPLAIN). + Disponible a partir de PHP 8.5.0, cuando se compila con libsqlite >= 3.43.0. + + + + + + SQLite3Stmt::EXPLAIN_MODE_EXPLAIN + + + El comando funciona como si estuviera precedido por + EXPLAIN, y devuelve la información sobre los opcodes + de la máquina virtual. + Disponible a partir de PHP 8.5.0, cuando se compila con libsqlite >= 3.43.0. + + + + + + SQLite3Stmt::EXPLAIN_MODE_EXPLAIN_QUERY_PLAN + + + El comando funciona como si estuviera precedido por + EXPLAIN QUERY PLAN, y devuelve la información de alto + nivel sobre el plan de consulta. + Disponible a partir de PHP 8.5.0, cuando se compila con libsqlite >= 3.43.0. + + + + + +
+ + &reference.sqlite3.entities.sqlite3stmt; diff --git a/reference/sqlite3/sqlite3stmt/busy.xml b/reference/sqlite3/sqlite3stmt/busy.xml new file mode 100644 index 0000000000..9e747230a2 --- /dev/null +++ b/reference/sqlite3/sqlite3stmt/busy.xml @@ -0,0 +1,87 @@ + + + + + + SQLite3Stmt::busy + Indica si el comando se ha ejecutado pero aún no ha terminado + + + + &reftitle.description; + + public boolSQLite3Stmt::busy + + + + Indica si el comando está ocupado, es decir, si se ha iniciado con + SQLite3Stmt::execute y quedan filas por recuperar, + sin haber terminado ni haber sido reiniciado todavía. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Devuelve &true; si el comando se ha ejecutado y quedan filas por recuperar, + &false; en caso contrario. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.5.0 + + Se añadió este método. + + + + + + + + + &reftitle.seealso; + + SQLite3Stmt::execute + SQLite3Stmt::reset + SQLite3Stmt::close + + + + + diff --git a/reference/sqlite3/sqlite3stmt/explain.xml b/reference/sqlite3/sqlite3stmt/explain.xml new file mode 100644 index 0000000000..1ccf7648b6 --- /dev/null +++ b/reference/sqlite3/sqlite3stmt/explain.xml @@ -0,0 +1,66 @@ + + + + + + SQLite3Stmt::explain + Devuelve el modo explain del comando + + + + &reftitle.description; + + public intSQLite3Stmt::explain + + + + Devuelve el modo explain definido actualmente en el comando con + SQLite3Stmt::setExplain. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Devuelve uno de los valores + SQLite3Stmt::EXPLAIN_MODE_PREPARED, + SQLite3Stmt::EXPLAIN_MODE_EXPLAIN o + SQLite3Stmt::EXPLAIN_MODE_EXPLAIN_QUERY_PLAN. + + + + + &reftitle.seealso; + + SQLite3Stmt::setExplain + SQLite3Stmt::execute + SQLite3Stmt::reset + + + + + diff --git a/reference/sqlite3/sqlite3stmt/setexplain.xml b/reference/sqlite3/sqlite3stmt/setexplain.xml new file mode 100644 index 0000000000..ed40a38ca8 --- /dev/null +++ b/reference/sqlite3/sqlite3stmt/setexplain.xml @@ -0,0 +1,84 @@ + + + + + + SQLite3Stmt::setExplain + Modifica el modo explain del comando + + + + &reftitle.description; + + public boolSQLite3Stmt::setExplain + intmode + + + Modifica el modo explain del comando, de modo que se comporte como si su SQL + estuviera precedido por EXPLAIN o + EXPLAIN QUERY PLAN, o de nuevo como un comando ordinario. + + + + + &reftitle.parameters; + + + mode + + + Uno de los valores + SQLite3Stmt::EXPLAIN_MODE_PREPARED, + SQLite3Stmt::EXPLAIN_MODE_EXPLAIN o + SQLite3Stmt::EXPLAIN_MODE_EXPLAIN_QUERY_PLAN. + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.errors; + + Se lanza un ValueError si + mode no es una de las constantes + SQLite3Stmt::EXPLAIN_MODE_*. + + + + + &reftitle.seealso; + + SQLite3Stmt::explain + SQLite3Stmt::execute + + + + +