Skip to content

Commit 7bd84b1

Browse files
leonardolaraleonardolara
committed
sync with en rev
1 parent e9374ff commit 7bd84b1

21 files changed

Lines changed: 352 additions & 122 deletions

‎appendices/migration84/other-changes.xml‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 0f1d7fba407bd1385616508a1e42e31fe009bff2 Maintainer: leonardolara Status: ready -->
1+
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 858400b07586b88dcb1e17a95e7a178b54b89d86 Maintainer: leonardolara Status: ready -->
22
<sect1 xml:id="migration84.other-changes">
33
<title>Outras Alterações</title>
44

@@ -247,7 +247,7 @@
247247
</simpara>
248248

249249
<simpara>
250-
Uma nova constante <constant>PDO::PGSQL_ATTR_RESULT_MEMORY_SIZE</constant>
250+
Uma nova constante <constant>Pdo\Pgsql::ATTR_RESULT_MEMORY_SIZE</constant>
251251
foi adicionada para recuperar o uso de memória de resultados de consultas com o método
252252
<methodname>PDO::getAttribute</methodname> para drivers que suportam isso.
253253
</simpara>
@@ -324,7 +324,7 @@
324324

325325
<simpara>
326326
Adicionado suporte à recuperação de uso de memória de consultas com
327-
<constant>PDO::PGSQL_ATTR_RESULT_MEMORY_SIZE</constant>.
327+
<constant>Pdo\Pgsql::ATTR_RESULT_MEMORY_SIZE</constant>.
328328
</simpara>
329329

330330
<simpara>

‎reference/pdo_pgsql/constants.xml‎

Lines changed: 62 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 9b69a8dcce47d6619d6459914e784627cbb02a5f Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
2+
<!-- EN-Revision: 858400b07586b88dcb1e17a95e7a178b54b89d86 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
33
<section xml:id="ref.pdo-pgsql.constants" xmlns="http://docbook.org/ns/docbook">
44
&reftitle.constants;
55
&pdo.driver-constants;
@@ -12,6 +12,67 @@
1212
<listitem>
1313
<simpara>
1414
&Alias; <constant>Pdo\Pgsql::ATTR_DISABLE_PREPARES</constant>.
15+
A partir do PHP 8.5.0, esta constante está descontinuada.
16+
</simpara>
17+
</listitem>
18+
</varlistentry>
19+
<varlistentry xml:id="pdo.constants.pgsql-transaction-idle">
20+
<term>
21+
<constant>PDO::PGSQL_TRANSACTION_IDLE</constant>
22+
(<type>int</type>)
23+
</term>
24+
<listitem>
25+
<simpara>
26+
Equivalente a <constant>Pdo\Pgsql::TRANSACTION_IDLE</constant>.
27+
A partir do PHP 8.5.0, esta constante está descontinuada, pois não tem efeito.
28+
</simpara>
29+
</listitem>
30+
</varlistentry>
31+
<varlistentry xml:id="pdo.constants.pgsql-transaction-active">
32+
<term>
33+
<constant>PDO::PGSQL_TRANSACTION_ACTIVE</constant>
34+
(<type>int</type>)
35+
</term>
36+
<listitem>
37+
<simpara>
38+
Equivalente a <constant>Pdo\Pgsql::TRANSACTION_ACTIVE</constant>.
39+
A partir do PHP 8.5.0, esta constante está descontinuada, pois não tem efeito.
40+
</simpara>
41+
</listitem>
42+
</varlistentry>
43+
<varlistentry xml:id="pdo.constants.pgsql-transaction-intrans">
44+
<term>
45+
<constant>PDO::PGSQL_TRANSACTION_INTRANS</constant>
46+
(<type>int</type>)
47+
</term>
48+
<listitem>
49+
<simpara>
50+
Equivalente a <constant>Pdo\Pgsql::TRANSACTION_INTRANS</constant>.
51+
A partir do PHP 8.5.0, esta constante está descontinuada, pois não tem efeito.
52+
</simpara>
53+
</listitem>
54+
</varlistentry>
55+
<varlistentry xml:id="pdo.constants.pgsql-transaction-inerror">
56+
<term>
57+
<constant>PDO::PGSQL_TRANSACTION_INERROR</constant>
58+
(<type>int</type>)
59+
</term>
60+
<listitem>
61+
<simpara>
62+
Equivalente a <constant>Pdo\Pgsql::TRANSACTION_INERROR</constant>.
63+
A partir do PHP 8.5.0, esta constante está descontinuada, pois não tem efeito.
64+
</simpara>
65+
</listitem>
66+
</varlistentry>
67+
<varlistentry xml:id="pdo.constants.pgsql-transaction-unknown">
68+
<term>
69+
<constant>PDO::PGSQL_TRANSACTION_UNKNOWN</constant>
70+
(<type>int</type>)
71+
</term>
72+
<listitem>
73+
<simpara>
74+
Equivalente a <constant>Pdo\Pgsql::TRANSACTION_UNKNOWN</constant>.
75+
A partir do PHP 8.5.0, esta constante está descontinuada, pois não tem efeito.
1576
</simpara>
1677
</listitem>
1778
</varlistentry>

‎reference/pdo_pgsql/pdo-pgsql.xml‎

Lines changed: 27 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
1-
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 3f82c54505bbf99a7dfdee2ae7f674b1e2719bd3 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
2-
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.pdo-pgsql" role="class">
1+
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 858400b07586b88dcb1e17a95e7a178b54b89d86 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
2+
<reference xml:id="class.pdo-pgsql" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" role="class">
33
<title>A classe Pdo\Pgsql</title>
44
<titleabbrev>Pdo\Pgsql</titleabbrev>
55

@@ -158,36 +158,51 @@
158158
<varlistentry xml:id="pdo-pgsql.constants.transaction-idle">
159159
<term><constant>Pdo\Pgsql::TRANSACTION_IDLE</constant></term>
160160
<listitem>
161-
<simpara>
162-
</simpara>
161+
<warning>
162+
<simpara>
163+
Esta constante não tem efeito e foi descontinuada a partir do PHP 8.5.0.
164+
</simpara>
165+
</warning>
163166
</listitem>
164167
</varlistentry>
165168
<varlistentry xml:id="pdo-pgsql.constants.transaction-active">
166169
<term><constant>Pdo\Pgsql::TRANSACTION_ACTIVE</constant></term>
167170
<listitem>
168-
<simpara>
169-
</simpara>
171+
<warning>
172+
<simpara>
173+
Esta constante não tem efeito e foi descontinuada a partir do PHP 8.5.0.
174+
</simpara>
175+
</warning>
170176
</listitem>
171177
</varlistentry>
172178
<varlistentry xml:id="pdo-pgsql.constants.transaction-intrans">
173179
<term><constant>Pdo\Pgsql::TRANSACTION_INTRANS</constant></term>
174180
<listitem>
175-
<simpara>
176-
</simpara>
181+
<warning>
182+
<simpara>
183+
Esta constante não tem efeito e foi descontinuada a partir do PHP 8.5.0.
184+
</simpara>
185+
</warning>
177186
</listitem>
178187
</varlistentry>
179188
<varlistentry xml:id="pdo-pgsql.constants.transaction-inerror">
180189
<term><constant>Pdo\Pgsql::TRANSACTION_INERROR</constant></term>
181190
<listitem>
182-
<simpara>
183-
</simpara>
191+
<warning>
192+
<simpara>
193+
Esta constante não tem efeito e foi descontinuada a partir do PHP 8.5.0.
194+
</simpara>
195+
</warning>
184196
</listitem>
185197
</varlistentry>
186198
<varlistentry xml:id="pdo-pgsql.constants.transaction-unknown">
187199
<term><constant>Pdo\Pgsql::TRANSACTION_UNKNOWN</constant></term>
188200
<listitem>
189-
<simpara>
190-
</simpara>
201+
<warning>
202+
<simpara>
203+
Esta constante não tem efeito e foi descontinuada a partir do PHP 8.5.0.
204+
</simpara>
205+
</warning>
191206
</listitem>
192207
</varlistentry>
193208
</variablelist>

‎reference/pdo_pgsql/pdo/pgsql/copyfromarray.xml‎

Lines changed: 43 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 9b69a8dcce47d6619d6459914e784627cbb02a5f Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
1+
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 858400b07586b88dcb1e17a95e7a178b54b89d86 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
22
<refentry xml:id="pdo-pgsql.copyfromarray" xmlns="http://docbook.org/ns/docbook">
33
<refnamediv>
44
<refname>Pdo\Pgsql::copyFromArray</refname>
@@ -77,40 +77,68 @@
7777
</simpara>
7878
</refsect1>
7979

80-
<!-- TODO?
81-
<refsect1 role="errors">
82-
&reftitle.errors;
83-
<simpara>
84-
When does this function issue <constant>E_*</constant> level errors,
85-
and/or throw <exceptionname>Exception</exceptionname>s.
86-
</simpara>
80+
<refsect1 role="changelog">
81+
&reftitle.changelog;
82+
<informaltable>
83+
<tgroup cols="2">
84+
<thead>
85+
<row>
86+
<entry>&Version;</entry>
87+
<entry>&Description;</entry>
88+
</row>
89+
</thead>
90+
<tbody>
91+
<row>
92+
<entry>8.5.0</entry>
93+
<entry>
94+
<parameter>rows</parameter> agora aceira um
95+
<classname>Traversable</classname>; anteriormente somente um
96+
<type>array</type> era aceito.
97+
</entry>
98+
</row>
99+
</tbody>
100+
</tgroup>
101+
</informaltable>
87102
</refsect1>
88-
-->
89103

90-
<!-- TODO?
91104
<refsect1 role="examples">
92105
&reftitle.examples;
93106
<example xml:id="pdo-pgsql.copyfromarray.example.basic">
94-
<title><methodname>Pdo\Pgsql::copyFromArray</methodname> example</title>
107+
<title>Exemplo de <methodname>Pdo\Pgsql::copyFromArray</methodname></title>
95108
<simpara>
96-
Description.
109+
Cada elemento de <parameter>rows</parameter> é um registro cujos campos são
110+
conectados por <parameter>separator</parameter> (uma tabulação por padrão).
97111
</simpara>
98112
<programlisting role="php">
99113
<![CDATA[
100114
<?php
101-
echo "Code example";
115+
$db = new Pdo\Pgsql('pgsql:dbname=test host=localhost', $user, $pass);
116+
$db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
117+
$db->exec('CREATE TABLE fruits (id int, name text, qty int)');
118+
119+
$rows = [
120+
"1\tapple\t10",
121+
"2\tbanana\t20",
122+
"3\tcherry\t30",
123+
];
124+
$db->copyFromArray('fruits', $rows);
125+
126+
foreach ($db->query('SELECT * FROM fruits ORDER BY id') as $row) {
127+
echo "{$row['id']} {$row['name']} {$row['qty']}\n";
128+
}
102129
?>
103130
]]>
104131
</programlisting>
105132
&example.outputs;
106133
<screen>
107134
<![CDATA[
108-
Code example
135+
1 apple 10
136+
2 banana 20
137+
3 cherry 30
109138
]]>
110139
</screen>
111140
</example>
112141
</refsect1>
113-
-->
114142

115143
<refsect1 role="seealso">
116144
&reftitle.seealso;

‎reference/pdo_pgsql/pdo/pgsql/copyfromfile.xml‎

Lines changed: 18 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 9b69a8dcce47d6619d6459914e784627cbb02a5f Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
1+
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 858400b07586b88dcb1e17a95e7a178b54b89d86 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
22
<refentry xml:id="pdo-pgsql.copyfromfile" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
33
<refnamediv>
44
<refname>Pdo\Pgsql::copyFromFile</refname>
@@ -55,40 +55,47 @@
5555
</simpara>
5656
</refsect1>
5757

58-
<!-- TODO?
5958
<refsect1 role="errors">
6059
&reftitle.errors;
6160
<simpara>
62-
When does this function issue <constant>E_*</constant> level errors,
63-
and/or throw <exceptionname>Exception</exceptionname>s.
61+
Se <parameter>filename</parameter> não puder ser aberto para leitura, a falha
62+
é reportada através da manipulação do erro da conexão
63+
(consulte <constant>PDO::ATTR_ERRMODE</constant>); com
64+
<constant>PDO::ERRMODE_EXCEPTION</constant>, uma
65+
<exceptionname>PDOException</exceptionname> é lançada.
6466
</simpara>
6567
</refsect1>
66-
-->
6768

68-
<!-- TODO?
6969
<refsect1 role="examples">
7070
&reftitle.examples;
7171
<example xml:id="pdo-pgsql.copyfromfile.example.basic">
72-
<title><methodname>Pdo\Pgsql::copyFromFile</methodname> example</title>
72+
<title>Exemplo de <methodname>Pdo\Pgsql::copyFromFile</methodname></title>
7373
<simpara>
74-
Description.
74+
O arquivo tem um registro por linha com campos conectados por
75+
<parameter>separator</parameter> (uma tabulação por padrão).
7576
</simpara>
7677
<programlisting role="php">
7778
<![CDATA[
7879
<?php
79-
echo "Code example";
80+
$db = new Pdo\Pgsql('pgsql:dbname=test host=localhost', $user, $pass);
81+
$db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
82+
$db->exec('CREATE TABLE fruits (id int, name text, qty int)');
83+
84+
file_put_contents('/tmp/fruits.tsv', "1\tapple\t10\n2\tbanana\t20\n");
85+
$db->copyFromFile('fruits', '/tmp/fruits.tsv');
86+
87+
echo $db->query('SELECT count(*) FROM fruits')->fetchColumn(), "\n";
8088
?>
8189
]]>
8290
</programlisting>
8391
&example.outputs;
8492
<screen>
8593
<![CDATA[
86-
Code example
94+
2
8795
]]>
8896
</screen>
8997
</example>
9098
</refsect1>
91-
-->
9299

93100
<refsect1 role="seealso">
94101
&reftitle.seealso;

‎reference/pdo_pgsql/pdo/pgsql/copytoarray.xml‎

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 9ec2c28f9400490fe1b70fb88e50e23de97905f1 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
1+
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 858400b07586b88dcb1e17a95e7a178b54b89d86 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
22
<refentry xml:id="pdo-pgsql.copytoarray" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
33
<refnamediv>
44
<refname>Pdo\Pgsql::copyToArray</refname>
@@ -49,40 +49,40 @@
4949
</simpara>
5050
</refsect1>
5151

52-
<!-- TODO?
53-
<refsect1 role="errors">
54-
&reftitle.errors;
55-
<simpara>
56-
When does this function issue <constant>E_*</constant> level errors,
57-
and/or throw <exceptionname>Exception</exceptionname>s.
58-
</simpara>
59-
</refsect1>
60-
-->
61-
62-
<!-- TODO?
6352
<refsect1 role="examples">
6453
&reftitle.examples;
6554
<example xml:id="pdo-pgsql.copytoarray.example.basic">
66-
<title><methodname>Pdo\Pgsql::copyToArray</methodname> example</title>
55+
<title>Exemplo de <methodname>Pdo\Pgsql::copyToArray</methodname></title>
6756
<simpara>
68-
Description.
57+
Cada elemento retornado é um registro com os campos conectados por
58+
<parameter>separator</parameter> e uma nova linha no final.
6959
</simpara>
7060
<programlisting role="php">
7161
<![CDATA[
7262
<?php
73-
echo "Code example";
63+
$db = new Pdo\Pgsql('pgsql:dbname=test host=localhost', $user, $pass);
64+
$db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
65+
$db->exec('CREATE TABLE fruits (id int, name text, qty int)');
66+
$db->exec("INSERT INTO fruits VALUES (1, 'apple', 10), (2, 'banana', 20)");
67+
68+
$rows = $db->copyToArray('fruits');
69+
var_export($rows);
7470
?>
7571
]]>
7672
</programlisting>
7773
&example.outputs;
7874
<screen>
7975
<![CDATA[
80-
Code example
76+
array (
77+
0 => '1 apple 10
78+
',
79+
1 => '2 banana 20
80+
',
81+
)
8182
]]>
8283
</screen>
8384
</example>
8485
</refsect1>
85-
-->
8686

8787
<refsect1 role="seealso">
8888
&reftitle.seealso;

0 commit comments

Comments
 (0)