Skip to content

Commit fc08179

Browse files
leonardolaraleonardolara
committed
sync with en rev
1 parent 9d7ff21 commit fc08179

5 files changed

Lines changed: 131 additions & 24 deletions

File tree

‎language/oop5/properties.xml‎

Lines changed: 9 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: dff848b17dafaabfb7662ffb5fecfcb04e3b771d Maintainer: leonardolara Status: ready --><!-- CREDITS: fabioluciano, ae, vinelouzada, leonardolara -->
2+
<!-- EN-Revision: 62e61e543c2d2b8519952efa246ed708026cfb16 Maintainer: leonardolara Status: ready --><!-- CREDITS: fabioluciano, ae, vinelouzada, leonardolara -->
33
<sect1 xml:id="language.oop5.properties" xmlns="http://docbook.org/ns/docbook">
44
<title>Propriedades</title>
55

@@ -361,6 +361,14 @@ var_dump($test2->prop); // NULL
361361
</programlisting>
362362
</example>
363363
</para>
364+
<note>
365+
<simpara>
366+
A partir do PHP 8.4.0, modificação indireta de uma propriedade somente-leitura dentro de
367+
<link linkend="object.clone">__clone()</link>, tal como a aquisição de uma
368+
referência a ela (<code>$ref = &amp;$this->prop</code>), não é mais
369+
permitida. Isto já era proibido durante a inicialização somente-leitura.
370+
</simpara>
371+
</note>
364372
</sect2>
365373

366374
<sect2 xml:id="language.oop5.properties.dynamic-properties">

‎language/operators/comparison.xml‎

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 16934048f79c6e117cd16a23c09c1b2ea502e284 Maintainer: leonardolara Status: ready --><!-- CREDITS: ae, leonardolara -->
1+
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 62e61e543c2d2b8519952efa246ed708026cfb16 Maintainer: leonardolara Status: ready --><!-- CREDITS: ae, leonardolara -->
22
<sect1 xml:id="language.operators.comparison">
33
<title>Operadores de Comparação</title>
44
<titleabbrev>Comparação</titleabbrev>
@@ -330,6 +330,15 @@ function standard_array_compare($op1, $op2)
330330
</simpara>
331331
</note>
332332

333+
<note>
334+
<simpara>
335+
A ocorrência de recursão durante uma comparação — por exemplo, ao comparar um
336+
array ou objeto que contenha uma referência a si mesmo — gera um
337+
<exceptionname>Error</exceptionname> a partir do PHP 8.4.0; anteriormente,
338+
isso resultava em um erro fatal.
339+
</simpara>
340+
</note>
341+
333342
<sect2 xml:id="language.operators.comparison.incomparable">
334343
<title>Valores não comparáveis</title>
335344
<simpara>

‎reference/curl/examples.xml‎

Lines changed: 69 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,84 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: fc9a0a8b29a7a099998bdd71fe5350a10b18fe62 Maintainer: leonardolara Status: ready --><!-- CREDITS: klaussilveira, leonardolara -->
2+
<!-- EN-Revision: e7c6a2f6847c3a8c9fec6ba588f235ccdcf6f3a5 Maintainer: leonardolara Status: ready --><!-- CREDITS: klaussilveira, leonardolara -->
33

44
<chapter xml:id="curl.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
&reftitle.examples;
66
<section xml:id="curl.examples-basic">
7-
<title>Exemplo básico do cURL</title>
8-
<para>
7+
<title>Exemplos básicos do cURL</title>
8+
<simpara>
99
Uma vez que o PHP tenha sido compilado com suporte ao cURL, pode-se começar a usar
1010
as funções cURL. A ideia por trás das funções cURL
1111
é inicializar uma sessão cURL usando
1212
<function>curl_init</function>, o que permite configurar as
1313
opções para a transferência através de <function>curl_setopt</function>,
1414
e depois executar a sessão com
1515
<function>curl_exec</function>.
16-
Aqui está um exemplo que usa as funções cURL para receber o conteúdo da página
16+
</simpara>
17+
<para>
18+
Aqui está um exemplo simples que usa as funções cURL para enviar
19+
uma requisição POST:
20+
<example>
21+
<title>Usando o módulo cURL do PHP para enviar uma requisição POST</title>
22+
<programlisting role="php">
23+
<![CDATA[
24+
<?php
25+
$data = ['foo' => 'bar', 'baz' => 48];
26+
$url = "http://www.example.com/handler.php";
27+
28+
$ch = curl_init($url);
29+
30+
// diz ao CURL para retornar a resposta em vez de enviá-la para stdout
31+
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
32+
33+
// define os dados POST, o método correspondente e os cabeçalhos
34+
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
35+
36+
// envia a requisição e obtém a resposta
37+
$response = curl_exec($ch);
38+
39+
if(curl_error($ch)) {
40+
// trata o erro, ou apenas
41+
throw new RuntimeException(curl_error($ch));
42+
}
43+
]]>
44+
</programlisting>
45+
</example>
46+
</para>
47+
<para>
48+
Outro exemplo que usa as funções cURL para enviar uma requisição POST
49+
com JSON:
50+
<example>
51+
<title>Usando o módulo cURL do PHP para enviar uma requisição POST com JSON</title>
52+
<programlisting role="php">
53+
<![CDATA[
54+
<?php
55+
$post_data = ['foo' => 'bar', 'baz' => 48];
56+
$url = "http://www.example.com/api/endpoint";
57+
58+
$ch = curl_init($url);
59+
60+
// diz ao CURL para retornar a resposta em vez de enviá-la para stdout
61+
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
62+
63+
// define os dados POST e o método correspondente
64+
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($post_data));
65+
66+
// define o cabeçalho necessário
67+
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
68+
69+
// envia a requisição e obtém a resposta
70+
$response = curl_exec($ch);
71+
72+
if(curl_error($ch)) {
73+
// trata o erro, ou apenas
74+
throw new RuntimeException(curl_error($ch));
75+
}
76+
]]>
77+
</programlisting>
78+
</example>
79+
</para>
80+
<para>
81+
Aqui está um outro exemplo que usa as funções cURL para receber o conteúdo da página
1782
inicial de exemplo.com.br em um arquivo:
1883
<example>
1984
<title>Usando o módulo cURL do PHP para receber a página exemplo.com.br</title>
@@ -32,7 +97,6 @@ if(curl_error($ch)) {
3297
fwrite($fp, curl_error($ch));
3398
}
3499
fclose($fp);
35-
?>
36100
]]>
37101
</programlisting>
38102
</example>

‎reference/errorfunc/functions/debug-print-backtrace.xml‎

Lines changed: 9 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: 1fd69376c6c90066f086c99a32621f0b3fd47ba0 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandoc,leonardolara -->
2+
<!-- EN-Revision: 41911b489877ce67e1a9c47b43b1cc37aa21b6e2 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandoc,leonardolara -->
33
<refentry xml:id="function.debug-print-backtrace" xmlns="http://docbook.org/ns/docbook">
44
<refnamediv>
55
<refname>debug_print_backtrace</refname>
@@ -42,6 +42,14 @@
4242
para economizar memória.
4343
</entry>
4444
</row>
45+
<row>
46+
<entry>DEBUG_BACKTRACE_PROVIDE_OBJECT</entry>
47+
<entry>
48+
Aceito para compatibilidade com <function>debug_backtrace</function>,
49+
mas não tem efeito: o rastreamento retroativo gerado é renderizado como uma string
50+
e a entrada "object" nunca é impressa.
51+
</entry>
52+
</row>
4553
</tbody>
4654
</tgroup>
4755
</table>

‎reference/gmp/functions/gmp-export.xml‎

Lines changed: 34 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 548548299328e56739eb2832a5c22ba2de745038 Maintainer: leonardolara Status: ready -->
2+
<!-- EN-Revision: ba0a95ac9ad601e5ef05a0f3ab937d9749395982 Maintainer: leonardolara Status: ready -->
33
<refentry xml:id="function.gmp-export" xmlns="http://docbook.org/ns/docbook">
44
<refnamediv>
55
<refname>gmp_export</refname>
@@ -14,9 +14,16 @@
1414
<methodparam choice="opt"><type>int</type><parameter>word_size</parameter><initializer>1</initializer></methodparam>
1515
<methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>GMP_MSW_FIRST | GMP_NATIVE_ENDIAN</initializer></methodparam>
1616
</methodsynopsis>
17-
<para>
18-
Exporta um número GMP para uma string binária.
19-
</para>
17+
<simpara>
18+
Exporta um número GMP para uma string binária. Esta função pode lidar com
19+
números arbitrariamente grandes além do alcance do inteiro nativo do PHP,
20+
com tamanho de palavra e ordem de bytes configuráveis, de forma semelhante
21+
à <function>pack</function>.
22+
</simpara>
23+
<simpara>
24+
O sinal do número é ignorado; exportar um número negativo
25+
produz o mesmo resultado que exportar seu valor absoluto.
26+
</simpara>
2027
</refsect1>
2128

2229
<refsect1 role="parameters">
@@ -26,25 +33,35 @@
2633
<varlistentry>
2734
<term><parameter>num</parameter></term>
2835
<listitem>
29-
<para>
30-
O número GMP que está sendo exportado.
31-
</para>
36+
<simpara>
37+
O número GMP a ser exportado.
38+
</simpara>
3239
</listitem>
3340
</varlistentry>
3441
<varlistentry>
3542
<term><parameter>word_size</parameter></term>
3643
<listitem>
37-
<para>
38-
O valor padrão é 1. O número de bytes em cada bloco de dados binários. Isso é usado principalmente em conjunto com o parâmetro options.
39-
</para>
44+
<simpara>
45+
O número de bytes por palavra na saída. O comprimento total da
46+
string retornada será um múltiplo deste valor.
47+
Valor padrão: <literal>1</literal>.
48+
</simpara>
4049
</listitem>
4150
</varlistentry>
4251
<varlistentry>
4352
<term><parameter>flags</parameter></term>
4453
<listitem>
45-
<para>
46-
O valor padrão é <constant>GMP_MSW_FIRST</constant> | <constant>GMP_NATIVE_ENDIAN</constant>.
47-
</para>
54+
<simpara>
55+
Uma máscara de bits que controla a ordem das palavras e a ordem dos bytes. Ordem das palavras:
56+
<constant>GMP_MSW_FIRST</constant> (palavra mais significativa primeiro,
57+
padrão) ou <constant>GMP_LSW_FIRST</constant> (palavra menos significativa
58+
primeiro). Ordem dos bytes dentro de cada palavra:
59+
<constant>GMP_NATIVE_ENDIAN</constant> (padrão),
60+
<constant>GMP_BIG_ENDIAN</constant>, ou
61+
<constant>GMP_LITTLE_ENDIAN</constant>.
62+
Valor padrão:
63+
<constant>GMP_MSW_FIRST</constant> | <constant>GMP_NATIVE_ENDIAN</constant>.
64+
</simpara>
4865
</listitem>
4966
</varlistentry>
5067
</variablelist>
@@ -53,9 +70,10 @@
5370

5471
<refsect1 role="returnvalues">
5572
&reftitle.returnvalues;
56-
<para>
57-
Retorna uma string.
58-
</para>
73+
<simpara>
74+
Retorna uma string contendo a representação binária do
75+
número GMP. A string está vazia se o número for zero.
76+
</simpara>
5977
</refsect1>
6078

6179
<refsect1 role="changelog">

0 commit comments

Comments
 (0)