sync with en rev

Author: leonardolara

reference/pdo/constants.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 5d8e96f9b174f7471daebce760657eb0f190b0ba Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
+<!-- EN-Revision: 205c3b8ad9af665e2b49dcc6020005bb479217a3 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
 <!-- Generated by xml_proto.php v2.1. Found in /scripts directory of phpdoc. -->
 <appendix xml:id="pdo.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
@@ -251,6 +251,13 @@
       a definição do tamanho do pré-busca. Um tamanho de pré-busca maior resulta em
       um aumento de desempenho com o custo de um uso maior de memória.
      </simpara>
+     <simpara>
+      O driver PDO_PGSQL, por sua vez, trata esse atributo como uma opção: a partir do PHP 8.5.0,
+      o valor <literal>0</literal> habilita a busca lenta (linha única);
+      consulte a
+      <link linkend="pdo-pgsql.constants.attr-prefetch">documentação do driver PDO_PGSQL</link>
+      para obter detalhes.
+     </simpara>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="pdo.constants.attr-timeout">

reference/pdo_pgsql/pdo-pgsql.xml

@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 858400b07586b88dcb1e17a95e7a178b54b89d86 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 205c3b8ad9af665e2b49dcc6020005bb479217a3 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
 <reference xml:id="class.pdo-pgsql" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" role="class">
  <title>A classe Pdo\Pgsql</title>
  <titleabbrev>Pdo\Pgsql</titleabbrev>
@@ -155,6 +155,32 @@
       </simpara>
      </listitem>
     </varlistentry>
+    <varlistentry xml:id="pdo-pgsql.constants.attr-prefetch">
+     <term><constant>PDO::ATTR_PREFETCH</constant></term>
+     <listitem>
+      <simpara>
+       A partir do PHP 8.5.0, definir este atributo como <literal>0</literal> habilita
+       a busca lenta (linha única): as linhas são recuperadas do servidor uma de cada vez
+       à medida que são buscadas, em vez de armazenar em buffer todo o conjunto de resultados na
+       memória antes da primeira chamada a <methodname>PDOStatement::fetch</methodname>.
+       Isso reduz o uso de memória para conjuntos grandes de resultados. Qualquer outro valor
+       mantém o comportamento padrão de buffer.
+      </simpara>
+      <simpara>
+       Pode ser definido para cada conexão com <methodname>PDO::setAttribute</methodname>,
+       ou por instrução através das opções de driver
+       <methodname>PDO::prepare</methodname> ou
+       <methodname>PDO::query</methodname>.
+      </simpara>
+      <caution>
+       <simpara>
+        No modo lento, uma conexão pode ter apenas uma instrução ativa por vez.
+        A execução de outra instrução descarta silenciosamente quaisquer linhas não
+        lidas da anterior; nenhum erro é gerado.
+       </simpara>
+      </caution>
+     </listitem>
+    </varlistentry>
     <varlistentry xml:id="pdo-pgsql.constants.transaction-idle">
      <term><constant>Pdo\Pgsql::TRANSACTION_IDLE</constant></term>
      <listitem>

reference/pdo_pgsql/pdo/pgsql/copyfromarray.xml

@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 858400b07586b88dcb1e17a95e7a178b54b89d86 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 205c3b8ad9af665e2b49dcc6020005bb479217a3 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
 <refentry xml:id="pdo-pgsql.copyfromarray" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>Pdo\Pgsql::copyFromArray</refname>
@@ -10,7 +10,7 @@
   <methodsynopsis role="Pdo\\Pgsql">
    <modifier>public</modifier> <type>bool</type><methodname>Pdo\Pgsql::copyFromArray</methodname>
    <methodparam><type>string</type><parameter>tableName</parameter></methodparam>
-   <methodparam><type>array</type><parameter>rows</parameter></methodparam>
+   <methodparam><type class="union"><type>array</type><type>Traversable</type></type><parameter>rows</parameter></methodparam>
    <methodparam choice="opt"><type>string</type><parameter>separator</parameter><initializer>"\t"</initializer></methodparam>
    <methodparam choice="opt"><type>string</type><parameter>nullAs</parameter><initializer>"\\\\N"</initializer></methodparam>
    <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>fields</parameter><initializer>&null;</initializer></methodparam>
@@ -37,8 +37,9 @@
     <term><parameter>rows</parameter></term>
     <listitem>
      <simpara>
-      Um <type>array</type> indexado de <type>string</type>s com
-      campos separados por <parameter>separator</parameter>.
+      Um <type>array</type> indexado (ou <type>Traversable</type>) de
+      <type>string</type>s com campos separados por
+      <parameter>separator</parameter>.
      </simpara>
     </listitem>
    </varlistentry>