From ed40ce3f40073aa28b4812dd65fda56688df6239 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Mon, 16 Nov 2026 07:48:20 +0100 Subject: [PATCH] [Sync-En] enchant, pdo, pdo_pgsql, clamp: carry over recent doc-en changes --- .../enchant-broker-get-dict-path.xml | 13 +++- .../enchant-broker-set-dict-path.xml | 13 +++- reference/math/functions/clamp.xml | 12 +-- reference/pdo/pdo/getattribute.xml | 75 +++++++++++++------ reference/pdo_pgsql/pdo-pgsql.xml | 70 +++++++++++++---- 5 files changed, 139 insertions(+), 44 deletions(-) diff --git a/reference/enchant/functions/enchant-broker-get-dict-path.xml b/reference/enchant/functions/enchant-broker-get-dict-path.xml index 65b055daf..ac2509534 100644 --- a/reference/enchant/functions/enchant-broker-get-dict-path.xml +++ b/reference/enchant/functions/enchant-broker-get-dict-path.xml @@ -1,6 +1,6 @@ - + @@ -49,6 +49,17 @@ + + &reftitle.errors; + + Lanza una ValueError si + broker no es utilizable, por ejemplo si no está + inicializado o ya fue liberado con + enchant_broker_free. + Esto solo ocurre si la extensión ha sido compilada con Enchant v1. + + + &reftitle.changelog; diff --git a/reference/enchant/functions/enchant-broker-set-dict-path.xml b/reference/enchant/functions/enchant-broker-set-dict-path.xml index 6df2479f3..39f22ac8e 100644 --- a/reference/enchant/functions/enchant-broker-set-dict-path.xml +++ b/reference/enchant/functions/enchant-broker-set-dict-path.xml @@ -1,6 +1,6 @@ - + @@ -57,6 +57,17 @@ + + &reftitle.errors; + + Lanza una ValueError si + broker no es utilizable, por ejemplo si no está + inicializado o ya fue liberado con + enchant_broker_free. + Esto solo ocurre si la extensión ha sido compilada con Enchant v1. + + + &reftitle.changelog; diff --git a/reference/math/functions/clamp.xml b/reference/math/functions/clamp.xml index 20f93b917..594286627 100644 --- a/reference/math/functions/clamp.xml +++ b/reference/math/functions/clamp.xml @@ -1,5 +1,5 @@ - + @@ -23,10 +23,10 @@ Los valores de tipos diferentes se compararán utilizando las reglas de comparación estándar. - Por ejemplo, un string no numérico se comparará con un int - como si fuera 0, pero varios valores string no numéricos - se compararán de forma alfanumérica. El valor devuelto será del tipo - original, sin aplicar ninguna conversión. + Por ejemplo, cuando un string no numérico se compara con un int, + el int se convierte a string y los valores se comparan como + cadenas. Varios valores string no numéricos también se comparan como + cadenas. El valor devuelto será del tipo original, sin aplicar ninguna conversión. @@ -105,7 +105,7 @@ echo clamp(103, min: 0, max: 100), PHP_EOL; // 100 echo clamp("J", min: "A", max: "F"), PHP_EOL; // "F" -clamp( +echo clamp( new \DateTimeImmutable('2025-08-01'), min: new \DateTimeImmutable('2025-08-15'), max: new \DateTimeImmutable('2025-09-15'), diff --git a/reference/pdo/pdo/getattribute.xml b/reference/pdo/pdo/getattribute.xml index 4b0ab00f5..e52e58954 100644 --- a/reference/pdo/pdo/getattribute.xml +++ b/reference/pdo/pdo/getattribute.xml @@ -1,5 +1,5 @@ - + @@ -21,10 +21,11 @@ la función PDOStatement::getAttribute. - - Tenga en cuenta que algunas bases de datos/drivers combinados no soportan todos los atributos - de conexión. - + + Solo los atributos genéricos enumerados a continuación pueden recuperarse + con todos los controladores. Que cualquier otro atributo pueda recuperarse + depende del controlador. + @@ -36,8 +37,9 @@ attribute - Una de las constantes PDO::ATTR_*. Los atributos genéricos - que se aplican a las conexiones son los siguientes: + Una de las constantes PDO::ATTR_*. + Los siguientes atributos genéricos son gestionados por el propio PDO + y pueden recuperarse con todos los controladores: PDO::ATTR_CASE PDO::ATTR_DEFAULT_FETCH_MODE @@ -50,7 +52,16 @@ - Algunos controladores pueden hacer uso de atributos adicionales específicos del controlador. + Todos los demás atributos son gestionados por el controlador. + Cuáles de ellos pueden recuperarse varía de un controlador a otro. + Esto incluye atributos genéricos como + PDO::ATTR_AUTOCOMMIT, + PDO::ATTR_CLIENT_VERSION, + PDO::ATTR_CONNECTION_STATUS, + PDO::ATTR_SERVER_INFO, + PDO::ATTR_SERVER_VERSION y + PDO::ATTR_TIMEOUT, + así como atributos específicos del controlador. Tenga en cuenta que los atributos específicos del controlador no deben ser utilizados con otros controladores. @@ -63,17 +74,21 @@ &reftitle.returnvalues; - Una llamada exitosa devuelve el valor del atributo PDO solicitado. - Una llamada que ha fallado devuelve &null;. + Devuelve el valor del atributo solicitado, o &false; en caso de error. + + + El valor de algunos atributos, como PDO::ATTR_PERSISTENT, + puede ser en sí mismo &false;, por lo que un valor de retorno &false; no + siempre indica un fallo. &reftitle.errors; - + El método PDO::getAttribute puede generar una excepción PDOException cuando el controlador subyacente no soporta el attribute solicitado. - + @@ -118,20 +133,38 @@ getAttribute(constant("PDO::ATTR_$val")) . "\n"; +$attributes = [ + 'DRIVER_NAME', 'ERRMODE', 'CASE', 'ORACLE_NULLS', 'PERSISTENT', + 'CLIENT_VERSION', 'SERVER_VERSION', 'AUTOCOMMIT', 'TIMEOUT', +]; + +foreach ($attributes as $name) { + try { + $value = $pdo->getAttribute(constant("PDO::ATTR_$name")); + echo "PDO::ATTR_$name: ", var_export($value, true), "\n"; + } catch (PDOException $e) { + echo "PDO::ATTR_$name: ", $e->getMessage(), "\n"; + } } ?> ]]> + &example.outputs.similar; + + + diff --git a/reference/pdo_pgsql/pdo-pgsql.xml b/reference/pdo_pgsql/pdo-pgsql.xml index 4fb7b23a3..00a9a4091 100644 --- a/reference/pdo_pgsql/pdo-pgsql.xml +++ b/reference/pdo_pgsql/pdo-pgsql.xml @@ -1,5 +1,5 @@ - + La clase Pdo\Pgsql Pdo\Pgsql @@ -74,9 +74,7 @@ &InheritedConstants; - - - + &Constants; @@ -91,6 +89,12 @@ int Pdo\Pgsql::ATTR_RESULT_MEMORY_SIZE + + public + const + int + Pdo\Pgsql::ATTR_CHUNK_SIZE + public const @@ -123,17 +127,11 @@ &Methods; - - - + &InheritedMethods; - - - - - - + + @@ -179,8 +177,12 @@ Puede establecerse por conexión con PDO::setAttribute, o por sentencia mediante - las opciones de controlador de PDO::prepare o - PDO::query. + las opciones de controlador de PDO::prepare. + + + Con la obtención perezosa, PDOStatement::rowCount + devuelve el número de filas recuperadas más recientemente del servidor, + no el total. @@ -191,6 +193,44 @@ + + Pdo\Pgsql::ATTR_CHUNK_SIZE + + + El número máximo de filas recuperadas del servidor a la vez durante la + obtención perezosa. + Permite equilibrar la velocidad con el uso de memoria. + + + Un valor de 1 a 2147483647 + activa la obtención perezosa y tiene prioridad sobre + PDO::ATTR_PREFETCH. + Con el valor por omisión de 0, + PDO::ATTR_PREFETCH determina cómo se obtienen las filas. + Cualquier otro entero lanza una ValueError. + + + Al igual que PDO::ATTR_PREFETCH, puede establecerse + por conexión o por sentencia. + Establecer PDO::ATTR_PREFETCH en la conexión o en + una sentencia anula el tamaño de bloque de la conexión. + + + Una sentencia con PDO::ATTR_CURSOR establecido en + PDO::CURSOR_SCROLL ignora el tamaño de bloque de la + conexión. + Establecer este atributo en 1 o más en una sentencia + de este tipo lanza una ValueError. + + + Para conocer las salvedades de la obtención perezosa, consulte + PDO::ATTR_PREFETCH. + + + Disponible a partir de PHP 8.6.0, cuando se compila con libpq >= 17. + + + Pdo\Pgsql::TRANSACTION_IDLE