Skip to content

Commit d6be0cc

Browse files
leonardolaraleonardolara
committed
sync with en rev
1 parent 72086dd commit d6be0cc

File tree

12 files changed

+119
-83
lines changed

12 files changed

+119
-83
lines changed

‎install/windows/recommended.xml

+1-1
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ opcache.enable_cli=On
4141

4242
Se um alto desempenho é requerido, deve-se usar cache de objetos na aplicação.
4343

44-
Consulte: <link xlink:href="&url.pecl.package;WinCache">http://pecl.php.net/package/WinCache</link>
44+
Consulte: <link xlink:href="&url.pecl.package;WinCache">&url.pecl.package;WinCache</link>
4545
para baixar uma DLL WinCache (or <filename>WINCACHE_<replaceable>*</replaceable>.tgz</filename>)
4646
para o diretório de extensões do PHP
4747
(<link linkend="ini.extension-dir">extension_dir</link> no <filename>php.ini</filename>).

‎language/control-structures/foreach.xml

+2-4
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 44ae7cb94991c11c93bc23f8a6544f81bb36cf1a Maintainer: leonardolara Status: ready --><!-- CREDITS: fabioluciano,geekcom,lhsazevedo,leonardolara -->
2+
<!-- EN-Revision: 53a400680d0cb2ddabd4493fb9846533c422e90d Maintainer: leonardolara Status: ready --><!-- CREDITS: fabioluciano,geekcom,lhsazevedo,leonardolara -->
33
<sect1 xml:id="control-structures.foreach" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
44
<title>foreach</title>
55
<?phpdoc print-version-for="foreach"?>
@@ -49,16 +49,15 @@ foreach (expressão_iterável as $chave => $valor) {
4949
<programlisting role="php">
5050
<![CDATA[
5151
<?php
52-
/* Exemplo: somente valor */
5352
53+
/* Exemplo: somente valor */
5454
$array = [1, 2, 3, 17];
5555
5656
foreach ($array as $value) {
5757
echo "Elemento atual de \$array: $value.\n";
5858
}
5959
6060
/* Exemplo: chave e valor */
61-
6261
$array = [
6362
"um" => 1,
6463
"dois" => 2,
@@ -84,7 +83,6 @@ foreach ($grid as $y => $row) {
8483
}
8584
8685
/* Exemplo: arrays dinâmicos */
87-
8886
foreach (range(1, 5) as $value) {
8987
echo "$value\n";
9088
}

‎reference/dom/domxpath/evaluate.xml

+3-2
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 21e1338e9721534c00085ff3cff25e2dd2e84dc9 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
3-
<refentry xml:id="domxpath.evaluate" xmlns="http://docbook.org/ns/docbook">
2+
<!-- EN-Revision: 01904e809eaf0aa60e7ce0524400ddd5681c9541 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
3+
<refentry xml:id="domxpath.evaluate" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
44
<refnamediv>
55
<refname>DOMXPath::evaluate</refname>
66
<refpurpose>
@@ -46,6 +46,7 @@
4646
</variablelist>
4747
</para>
4848
</refsect1>
49+
<xi:include xpointer="domxpath.query..errors" />
4950
<refsect1 role="returnvalues">
5051
&reftitle.returnvalues;
5152
<para>

‎reference/dom/domxpath/query.xml

+30-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 21e1338e9721534c00085ff3cff25e2dd2e84dc9 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
2+
<!-- EN-Revision: 01904e809eaf0aa60e7ce0524400ddd5681c9541 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
33
<refentry xml:id="domxpath.query" xmlns="http://docbook.org/ns/docbook">
44
<refnamediv>
55
<refname>DOMXPath::query</refname>
@@ -59,6 +59,35 @@
5959
<methodname>DOMXPath::query</methodname> retorna &false;.
6060
</para>
6161
</refsect1>
62+
<refsect1 role="errors" xml:id="domxpath.query..errors">
63+
&reftitle.errors;
64+
<simpara>
65+
Os seguintes erros são possíveis ao usar uma expressão que invoca
66+
retornos de chamada PHP.
67+
</simpara>
68+
<itemizedlist>
69+
<listitem>
70+
<simpara>
71+
Lança um <exceptionname>Error</exceptionname> se
72+
um retorno de chamada do PHP for invocado, mas não houver nenhum retorno de chamada registrado
73+
ou se o retorno de chamada nomeado não tiver sido registrado.
74+
</simpara>
75+
</listitem>
76+
<listitem>
77+
<simpara>
78+
Lança um <exceptionname>TypeError</exceptionname> se
79+
a sintaxe <literal>php:function</literal> for usada e o nome do manipulador
80+
não for uma string.
81+
</simpara>
82+
</listitem>
83+
<listitem>
84+
<simpara>
85+
Lança um <exceptionname>Error</exceptionname> se
86+
um objeto não DOM foi retornado de um retorno de chamada.
87+
</simpara>
88+
</listitem>
89+
</itemizedlist>
90+
</refsect1>
6291
<refsect1 role="examples">
6392
&reftitle.examples;
6493
<para>

‎reference/dom/domxpath/registerphpfunctions.xml

+29-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 2bd9a67c8c6c5961189f868364837a5c3ba7e063 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
2+
<!-- EN-Revision: 01904e809eaf0aa60e7ce0524400ddd5681c9541 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
33
<refentry xml:id="domxpath.registerphpfunctions" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
44
<refnamediv>
55
<refname>DOMXPath::registerPhpFunctions</refname>
@@ -48,6 +48,25 @@
4848
</para>
4949
</refsect1>
5050

51+
<refsect1 role="errors" xml:id="domxpath.registerphpfunctions..errors">
52+
&reftitle.errors;
53+
<itemizedlist>
54+
<listitem>
55+
<simpara>
56+
Lança uma exceção <exceptionname>ValueError</exceptionname> se
57+
um nome de chamada de retorno não for válido.
58+
</simpara>
59+
</listitem>
60+
&dom.errors.compliant.common;
61+
<listitem>
62+
<simpara>
63+
Lança uma exceção <exceptionname>TypeError</exceptionname> se
64+
uma função de retorno informada não for chamável.
65+
</simpara>
66+
</listitem>
67+
</itemizedlist>
68+
</refsect1>
69+
5170
<refsect1 role="changelog">
5271
&reftitle.changelog;
5372
<informaltable>
@@ -59,6 +78,15 @@
5978
</row>
6079
</thead>
6180
<tbody>
81+
<row xml:id="domxpath.registerphpfunctions..changelog.errors">
82+
<entry>8.4.0</entry>
83+
<entry>
84+
Nomes de retorno de chamada inválidos agora lançam uma exceção
85+
<exceptionname>ValueError</exceptionname>.
86+
Passar uma entrada que não pode ser chamada agora lança uma exceção
87+
<exceptionname>TypeError</exceptionname>.
88+
</entry>
89+
</row>
6290
<row>
6391
<entry>8.4.0</entry>
6492
<entry>

‎reference/password/functions/password-hash.xml

+21-18
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 762b61c66262a1e0c329dacdcc3be6f1702c299d Maintainer: leonardolara Status: ready --><!-- CREDITS: rogeriopradoj,lisaldo,rogeriopradoj,leonardolara -->
2+
<!-- EN-Revision: e302f07943465892db7f72469e2ce9b42c4f763f Maintainer: leonardolara Status: ready --><!-- CREDITS: rogeriopradoj,lisaldo,rogeriopradoj,leonardolara -->
33
<refentry xml:id="function.password-hash" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
44
<refnamediv>
55
<refname>password_hash</refname>
@@ -34,9 +34,9 @@
3434
</listitem>
3535
<listitem>
3636
<simpara>
37-
<constant>PASSWORD_BCRYPT</constant> - Usa o algoritmo <constant>CRYPT_BLOWFISH</constant> para
37+
<constant>PASSWORD_BCRYPT</constant> - Usa o algoritmo bcrypt para
3838
criar o hash. Produzirá um hash compatível com o padrão <function>crypt</function> usando
39-
o identificador "$2y$". O resultado será sempre uma string de 60 caracteres, &return.falseforfailure;.
39+
o identificador <literal>$2y$</literal>. O resultado será sempre uma string de 60 caracteres, &return.falseforfailure;.
4040
</simpara>
4141
</listitem>
4242
<listitem>
@@ -81,8 +81,8 @@
8181
Exemplos desses valores podem ser encontrados na página da função <function>crypt</function>.
8282
</para>
8383
<para>
84-
Se omitido, um valor padrão <literal>10</literal> será usado. Este é um bom
85-
patamar de custo, mas pode-se considerar aumentar esse valor dependendo do hardware.
84+
Se omitido, um valor padrão <literal>12</literal> será usado. Este é um bom
85+
patamar de custo, mas pode-se considerar ajuste nesse valor dependendo do hardware.
8686
</para>
8787
</listitem>
8888
</itemizedlist>
@@ -153,10 +153,6 @@
153153
<para>
154154
&password.parameter.options;
155155
</para>
156-
<para>
157-
Se omitido, um salt aleatório será gerado e o custo padrão será
158-
usado.
159-
</para>
160156
</listitem>
161157
</varlistentry>
162158
</variablelist>
@@ -187,6 +183,14 @@
187183
</row>
188184
</thead>
189185
<tbody>
186+
<row>
187+
<entry>8.4.0</entry>
188+
<entry>
189+
O valor padrão da opção <literal>cost</literal> do algoritmo
190+
<constant>PASSWORD_BCRYPT</constant> foi aumentado de
191+
<literal>10</literal> para <literal>12</literal>.
192+
</entry>
193+
</row>
190194
<row>
191195
<entry>8.3.0</entry>
192196
<entry>
@@ -265,7 +269,7 @@ echo password_hash("rasmuslerdorf", PASSWORD_DEFAULT);
265269
&example.outputs.similar;
266270
<screen>
267271
<![CDATA[
268-
$2y$10$.vGA1O9wmRjrwAVXD98HNOgsNpDczlqm3Jq7KnEd1rVAGv3Fykk1a
272+
$2y$12$4Umg0rCJwMswRw/l.SwHvuQV01coP0eWmGzd61QH2RvAOMANUBGC.
269273
]]>
270274
</screen>
271275
</example>
@@ -277,11 +281,10 @@ $2y$10$.vGA1O9wmRjrwAVXD98HNOgsNpDczlqm3Jq7KnEd1rVAGv3Fykk1a
277281
<![CDATA[
278282
<?php
279283
/**
280-
* Neste caso, o objetivo é aumentar o custo padrão de BCRYPT para 12.
281-
* Note que agora o algortimo foi trocado para PASSWORD_BCRYPT, que sempre terá 60 caracteres.
284+
* Neste caso, o objetivo é aumentar o custo padrão de BCRYPT para 13.
282285
*/
283286
$options = [
284-
'cost' => 12,
287+
'cost' => 13,
285288
];
286289
echo password_hash("rasmuslerdorf", PASSWORD_BCRYPT, $options);
287290
?>
@@ -290,7 +293,7 @@ echo password_hash("rasmuslerdorf", PASSWORD_BCRYPT, $options);
290293
&example.outputs.similar;
291294
<screen>
292295
<![CDATA[
293-
$2y$12$QjSH496pcT5CEbzjD/vtVeH03tfHKFy36d4J0Ltp3lRtee9HDxY3K
296+
$2y$13$xeDfQumlmdm0Sco.4qmH1OGfUUmOcuRmfae0dPJhjX1Bq0yYhqbNi
294297
]]>
295298
</screen>
296299
</example>
@@ -303,14 +306,14 @@ $2y$12$QjSH496pcT5CEbzjD/vtVeH03tfHKFy36d4J0Ltp3lRtee9HDxY3K
303306
<?php
304307
/**
305308
* Este código irá verificar o desempenho do servidor para determinar o quanto pode-se aumentar
306-
* o custo. O objetivo é aumentar o custo ao valor mais alto possível sem deixar o servidor muito
307-
* lento. 10 é um bom ponto de partida, e um valor maior será bom se o servidor for
309+
* o custo. O objetivo é aumentar o custo ao valor mais alto possível sem deixar o servidor
310+
* muito lento. 11 é um bom ponto de partida, e um valor maior será bom se o servidor for
308311
* rápido o suficiente. O código abaix mira em ≤ 350 milissegundos de tempo adicional,
309312
* que é um atraso adequado para sistemas que lidam com logins interativos.
310313
*/
311314
$timeTarget = 0.350; // 350 milissegundos
312315
313-
$cost = 10;
316+
$cost = 11;
314317
do {
315318
$cost++;
316319
$start = microtime(true);
@@ -325,7 +328,7 @@ echo "Custo Apropriado Encontrado: " . $cost;
325328
&example.outputs.similar;
326329
<screen>
327330
<![CDATA[
328-
Custo Apropriado Encontrado: 12
331+
Custo Apropriado Encontrado: 13
329332
]]>
330333
</screen>
331334
</example>

‎reference/password/functions/password-needs-rehash.xml

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: ff492e168a557e4dd17574023b7c3cb21b14df3b Maintainer: leonardolara Status: ready --><!-- CREDITS: rogeriopradoj,leonardolara -->
2+
<!-- EN-Revision: e302f07943465892db7f72469e2ce9b42c4f763f Maintainer: leonardolara Status: ready --><!-- CREDITS: rogeriopradoj,leonardolara -->
33

44
<refentry xml:id="function.password-needs-rehash" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
@@ -96,11 +96,11 @@
9696
<?php
9797
9898
$password = 'rasmuslerdorf';
99-
$hash = '$2y$10$YCFsG6elYca568hBi2pZ0.3LDL5wjgxct1N8w/oLR/jfHsiQwCqTS';
99+
$hash = '$2y$12$4Umg0rCJwMswRw/l.SwHvuQV01coP0eWmGzd61QH2RvAOMANUBGC.';
100100
101101
$algorithm = PASSWORD_BCRYPT;
102102
// o parâmetro de custo de bcrypt pode mudar com o tempo com a evloução dos equipamentos
103-
$options = ['cost' => 12];
103+
$options = ['cost' => 13];
104104
105105
// Verifica o hash armazenado comparando com uma senha em texto puro
106106
if (password_verify($password, $hash)) {

‎reference/password/functions/password-verify.xml

+2-3
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 5bc68add3da3cd18c40f851e944b15095d3a26aa Maintainer: leonardolara Status: ready --><!-- CREDITS: rogeriopradoj,leonardolara -->
2+
<!-- EN-Revision: 5baba54a67be43d689970983cfc6d24debad1ce0 Maintainer: leonardolara Status: ready --><!-- CREDITS: rogeriopradoj,leonardolara -->
33
<refentry xml:id="function.password-verify" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
44
<refnamediv>
55
<refname>password_verify</refname>
@@ -72,7 +72,7 @@
7272
<![CDATA[
7373
<?php
7474
// Veja o exemplo de password_hash() para ver de onde veio esta string.
75-
$hash = '$2y$10$.vGA1O9wmRjrwAVXD98HNOgsNpDczlqm3Jq7KnEd1rVAGv3Fykk1a';
75+
$hash = '$2y$12$4Umg0rCJwMswRw/l.SwHvuQV01coP0eWmGzd61QH2RvAOMANUBGC.';
7676
7777
if (password_verify('rasmuslerdorf', $hash)) {
7878
echo 'Senha válida!';
@@ -98,7 +98,6 @@ Senha válida!
9898
<simplelist>
9999
<member><function>password_needs_rehash</function></member>
100100
<member><function>password_hash</function></member>
101-
<member><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.password.compat;">implementação no espaço de usuário</link></member>
102101
<member><function>sodium_crypto_pwhash_str_verify</function></member>
103102
</simplelist>
104103
</para>

‎reference/xsl/xsltprocessor/registerphpfunctions.xml

+5-2
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 4d8af0862acd95744e96db9e611a9e6c1b02521e Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe, adiel, leonardolara -->
3-
<refentry xml:id="xsltprocessor.registerphpfunctions" xmlns="http://docbook.org/ns/docbook">
2+
<!-- EN-Revision: 01904e809eaf0aa60e7ce0524400ddd5681c9541 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe, adiel, leonardolara -->
3+
<refentry xml:id="xsltprocessor.registerphpfunctions" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
44
<refnamediv>
55
<refname>XSLTProcessor::registerPHPFunctions</refname>
66
<refpurpose>Habilita o uso de funções do PHP como funções XSLT</refpurpose>
@@ -40,6 +40,8 @@
4040
</para>
4141
</refsect1>
4242

43+
<xi:include xpointer="domxpath.registerphpfunctions..errors" />
44+
4345
<refsect1 role="returnvalues">
4446
&reftitle.returnvalues;
4547
<para>
@@ -58,6 +60,7 @@
5860
</row>
5961
</thead>
6062
<tbody>
63+
<xi:include xpointer="domxpath.registerphpfunctions..changelog.errors" />
6164
<row>
6265
<entry>8.4.0</entry>
6366
<entry>

‎reference/xsl/xsltprocessor/transformtodoc.xml

+6-23
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 256782d03224fa268ebf0111ce5f6bbf27897ab3 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe,leonardolara -->
3-
<refentry xml:id="xsltprocessor.transformtodoc" xmlns="http://docbook.org/ns/docbook">
2+
<!-- EN-Revision: 01904e809eaf0aa60e7ce0524400ddd5681c9541 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe,leonardolara -->
3+
<refentry xml:id="xsltprocessor.transformtodoc" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
44
<refnamediv>
55
<refname>XSLTProcessor::transformToDoc</refname>
66
<refpurpose>Transforma em um documento</refpurpose>
@@ -45,34 +45,17 @@
4545
</variablelist>
4646
</para>
4747
</refsect1>
48+
49+
<xi:include xpointer="domxpath.query..errors" />
50+
4851
<refsect1 role="returnvalues">
4952
&reftitle.returnvalues;
5053
<para>
5154
O documento resultante ou &false; em caso de erro.
5255
</para>
5356
</refsect1>
5457

55-
<refsect1 role="changelog">
56-
&reftitle.changelog;
57-
<informaltable>
58-
<tgroup cols="2">
59-
<thead>
60-
<row>
61-
<entry>&Version;</entry>
62-
<entry>&Description;</entry>
63-
</row>
64-
</thead>
65-
<tbody>
66-
<row>
67-
<entry>8.4.0</entry>
68-
<entry>
69-
Adicionado suporte para <classname>Dom\Document</classname>.
70-
</entry>
71-
</row>
72-
</tbody>
73-
</tgroup>
74-
</informaltable>
75-
</refsect1>
58+
<xi:include xpointer="xsltprocessor.transformtouri..changelog" />
7659

7760
<refsect1 role="examples">
7861
&reftitle.examples;

0 commit comments

Comments
 (0)