Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
13 changes: 12 additions & 1 deletion reference/enchant/functions/enchant-broker-get-dict-path.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 8dc5bef8981ffd33c8c51f7f33414fcf5c03767a Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: b5f0a56490ca4a96b3aa35445d16024f545d01e2 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.enchant-broker-get-dict-path" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand Down Expand Up @@ -49,6 +49,17 @@
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Lanza una <exceptionname>ValueError</exceptionname> si
<parameter>broker</parameter> no es utilizable, por ejemplo si no está
inicializado o ya fue liberado con
<function>enchant_broker_free</function>.
Esto solo ocurre si la extensión ha sido compilada con Enchant v1.
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
Expand Down
13 changes: 12 additions & 1 deletion reference/enchant/functions/enchant-broker-set-dict-path.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 8dc5bef8981ffd33c8c51f7f33414fcf5c03767a Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: b5f0a56490ca4a96b3aa35445d16024f545d01e2 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.enchant-broker-set-dict-path" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand Down Expand Up @@ -57,6 +57,17 @@
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Lanza una <exceptionname>ValueError</exceptionname> si
<parameter>broker</parameter> no es utilizable, por ejemplo si no está
inicializado o ya fue liberado con
<function>enchant_broker_free</function>.
Esto solo ocurre si la extensión ha sido compilada con Enchant v1.
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
Expand Down
12 changes: 6 additions & 6 deletions reference/math/functions/clamp.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bc21afc0cf0e58f48e5351fd9d5d86a0ddd71c8a Maintainer: lacatoire Status: ready -->
<!-- EN-Revision: 2fda4df7d2f44e6edbf64976dceddcb7cb8c6fd7 Maintainer: lacatoire Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.clamp" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand All @@ -23,10 +23,10 @@
<simpara>
Los valores de tipos diferentes se compararán utilizando las
<link linkend="language.operators.comparison">reglas de comparación estándar</link>.
Por ejemplo, un <type>string</type> no numérico se comparará con un <type>int</type>
como si fuera <literal>0</literal>, pero varios valores <type>string</type> 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 <type>string</type> no numérico se compara con un <type>int</type>,
el <type>int</type> se convierte a <type>string</type> y los valores se comparan como
cadenas. Varios valores <type>string</type> no numéricos también se comparan como
cadenas. El valor devuelto será del tipo original, sin aplicar ninguna conversión.
</simpara>
</note>
<caution>
Expand Down Expand Up @@ -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'),
Expand Down
75 changes: 54 additions & 21 deletions reference/pdo/pdo/getattribute.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 00b118595a963f00211e96224e3fba35bdebc83c Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: ea010c6c957f8fdd64e1d622ab5fbe584cf3d231 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="pdo.getattribute" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand All @@ -21,10 +21,11 @@
la función <methodname>PDOStatement::getAttribute</methodname>.
</para>

<para>
Tenga en cuenta que algunas bases de datos/drivers combinados no soportan todos los atributos
de conexión.
</para>
<simpara>
Solo los atributos genéricos enumerados a continuación pueden recuperarse
con todos los controladores. Que cualquier otro atributo pueda recuperarse
depende del controlador.
</simpara>

</refsect1>

Expand All @@ -36,8 +37,9 @@
<term><parameter>attribute</parameter></term>
<listitem>
<para>
Una de las constantes <constant>PDO::ATTR_<replaceable>*</replaceable></constant>. Los atributos genéricos
que se aplican a las conexiones son los siguientes:
Una de las constantes <constant>PDO::ATTR_<replaceable>*</replaceable></constant>.
Los siguientes atributos genéricos son gestionados por el propio PDO
y pueden recuperarse con todos los controladores:
<simplelist>
<member><constant>PDO::ATTR_CASE</constant></member>
<member><constant>PDO::ATTR_DEFAULT_FETCH_MODE</constant></member>
Expand All @@ -50,7 +52,16 @@
</simplelist>
</para>
<simpara>
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
<constant>PDO::ATTR_AUTOCOMMIT</constant>,
<constant>PDO::ATTR_CLIENT_VERSION</constant>,
<constant>PDO::ATTR_CONNECTION_STATUS</constant>,
<constant>PDO::ATTR_SERVER_INFO</constant>,
<constant>PDO::ATTR_SERVER_VERSION</constant> y
<constant>PDO::ATTR_TIMEOUT</constant>,
así como atributos específicos del controlador.
Tenga en cuenta que los atributos específicos del controlador <emphasis>no deben</emphasis>
ser utilizados con otros controladores.
</simpara>
Expand All @@ -63,17 +74,21 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
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.
</simpara>
<simpara>
El valor de algunos atributos, como <constant>PDO::ATTR_PERSISTENT</constant>,
puede ser en sí mismo &false;, por lo que un valor de retorno &false; no
siempre indica un fallo.
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<para>
<simpara>
El método <methodname>PDO::getAttribute</methodname> puede generar una excepción <exceptionname>PDOException</exceptionname>
cuando el controlador subyacente no soporta el <parameter>attribute</parameter> solicitado.
</para>
</simpara>
</refsect1>

<refsect1 role="changelog">
Expand Down Expand Up @@ -118,20 +133,38 @@
<programlisting role="php">
<![CDATA[
<?php
$conn = new PDO('odbc:sample', 'db2inst1', 'ibmdb2');
$attributes = array(
"AUTOCOMMIT", "ERRMODE", "CASE", "CLIENT_VERSION", "CONNECTION_STATUS",
"ORACLE_NULLS", "PERSISTENT", "PREFETCH", "SERVER_INFO", "SERVER_VERSION",
"TIMEOUT"
);
$pdo = new PDO('sqlite::memory:');

foreach ($attributes as $val) {
echo "PDO::ATTR_$val: ";
echo $conn->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";
}
}
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
PDO::ATTR_DRIVER_NAME: 'sqlite'
PDO::ATTR_ERRMODE: 2
PDO::ATTR_CASE: 0
PDO::ATTR_ORACLE_NULLS: 0
PDO::ATTR_PERSISTENT: false
PDO::ATTR_CLIENT_VERSION: '3.46.1'
PDO::ATTR_SERVER_VERSION: '3.46.1'
PDO::ATTR_AUTOCOMMIT: SQLSTATE[IM001]: Driver does not support this function: driver does not support that attribute
PDO::ATTR_TIMEOUT: SQLSTATE[IM001]: Driver does not support this function: driver does not support that attribute
]]>
</screen>
</example>
</para>
</refsect1>
Expand Down
70 changes: 55 additions & 15 deletions reference/pdo_pgsql/pdo-pgsql.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 371e92c3d8d9ee92542dfae4dee1d9fd0c940385 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 6816d24b1a44f0180c46b6dd28b5aeb60a15a30b Maintainer: PhilDaiguille Status: ready -->
<reference xml:id="class.pdo-pgsql" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" role="class">
<title>La clase Pdo\Pgsql</title>
<titleabbrev>Pdo\Pgsql</titleabbrev>
Expand Down Expand Up @@ -74,9 +74,7 @@
</ooclass>

<classsynopsisinfo role="comment">&InheritedConstants;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Constants;']]))">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Constants;']]))"/>

<classsynopsisinfo role="comment">&Constants;</classsynopsisinfo>
<fieldsynopsis>
Expand All @@ -91,6 +89,12 @@
<type>int</type>
<varname linkend="pdo-pgsql.constants.attr-result-memory-size">Pdo\Pgsql::ATTR_RESULT_MEMORY_SIZE</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="pdo-pgsql.constants.attr-chunk-size">Pdo\Pgsql::ATTR_CHUNK_SIZE</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
Expand Down Expand Up @@ -123,17 +127,11 @@
</fieldsynopsis>

<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo-pgsql')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Pdo\\Pgsql'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo-pgsql')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Pdo\\Pgsql'])"/>

<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='PDO'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='PDO'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='PDO'])"/>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='PDO'])"/>
</classsynopsis>
</packagesynopsis>
<!-- }}} -->
Expand Down Expand Up @@ -179,8 +177,12 @@
<simpara>
Puede establecerse por conexión con
<methodname>PDO::setAttribute</methodname>, o por sentencia mediante
las opciones de controlador de <methodname>PDO::prepare</methodname> o
<methodname>PDO::query</methodname>.
las opciones de controlador de <methodname>PDO::prepare</methodname>.
</simpara>
<simpara>
Con la obtención perezosa, <methodname>PDOStatement::rowCount</methodname>
devuelve el número de filas recuperadas más recientemente del servidor,
no el total.
</simpara>
<caution>
<simpara>
Expand All @@ -191,6 +193,44 @@
</caution>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-pgsql.constants.attr-chunk-size">
<term><constant>Pdo\Pgsql::ATTR_CHUNK_SIZE</constant></term>
<listitem>
<simpara>
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.
</simpara>
<simpara>
Un valor de <literal>1</literal> a <literal>2147483647</literal>
activa la obtención perezosa y tiene prioridad sobre
<constant>PDO::ATTR_PREFETCH</constant>.
Con el valor por omisión de <literal>0</literal>,
<constant>PDO::ATTR_PREFETCH</constant> determina cómo se obtienen las filas.
Cualquier otro entero lanza una <exceptionname>ValueError</exceptionname>.
</simpara>
<simpara>
Al igual que <constant>PDO::ATTR_PREFETCH</constant>, puede establecerse
por conexión o por sentencia.
Establecer <constant>PDO::ATTR_PREFETCH</constant> en la conexión o en
una sentencia anula el tamaño de bloque de la conexión.
</simpara>
<simpara>
Una sentencia con <constant>PDO::ATTR_CURSOR</constant> establecido en
<constant>PDO::CURSOR_SCROLL</constant> ignora el tamaño de bloque de la
conexión.
Establecer este atributo en <literal>1</literal> o más en una sentencia
de este tipo lanza una <exceptionname>ValueError</exceptionname>.
</simpara>
<simpara>
Para conocer las salvedades de la obtención perezosa, consulte
<link linkend="pdo-pgsql.constants.attr-prefetch">PDO::ATTR_PREFETCH</link>.
</simpara>
<simpara>
Disponible a partir de PHP 8.6.0, cuando se compila con libpq &gt;= 17.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-pgsql.constants.transaction-idle">
<term><constant>Pdo\Pgsql::TRANSACTION_IDLE</constant></term>
<listitem>
Expand Down
Loading