Skip to content

Commit 5fe93ae

Browse files
leonardolaraleonardolara
committed
sync with en rev
1 parent cf42609 commit 5fe93ae

File tree

3 files changed

+61
-25
lines changed

3 files changed

+61
-25
lines changed

Diff for: ‎language/basic-syntax.xml

+14-9
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,26 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: f4f96ef8b2a95283c92ea2183fe1dedf06f3ad22 Maintainer: leonardolara Status: ready --><!-- CREDITS: fabioluciano,geekcom,ae,gabrielsanva,adiel,leonardolara -->
2+
<!-- EN-Revision: 8ad67ee7a8cc6c9d7a4cf78065cab87bf2e6c08e Maintainer: leonardolara Status: ready --><!-- CREDITS: fabioluciano,geekcom,ae,gabrielsanva,adiel,leonardolara -->
33
<chapter xml:id="language.basic-syntax" xmlns="http://docbook.org/ns/docbook">
44
<title>Sintaxe Básica</title>
55
<sect1 xml:id="language.basic-syntax.phptags">
66
<title>Tags PHP</title>
77
<para>
8-
Quando o PHP processa um arquivo, ele procura pelas tags de abertura e fechamento,
9-
<literal>&lt;?php</literal> e <literal>?&gt;</literal>, que dizem ao PHP para
10-
iniciar ou parar a interpretação do código entre elas. Essa forma de processamento
11-
permite que o PHP seja incluído em todo tipo de documentos, pois tudo
12-
que estiver fora destas tags será ignorado pelo
13-
interpretador PHP.
8+
Quando o PHP processa um arquivo, ele reconhece as etiquetas de abertura e
9+
fechamento, <literal>&lt;?php</literal> e <literal>?&gt;</literal>, para
10+
definir os limites da execução de código PHP. O conteúdo fora destas
11+
etiquetas é ignorado pelo interpretador PHP, permitindo que o PHP
12+
seja incluído em vários tipos de documentos.
1413
</para>
1514

1615
<para>
17-
O PHP inclui uma tag echo curta <literal>&lt;?=</literal> que é uma
18-
forma abreviada da forma mais verbosa <code>&lt;?php echo</code>.
16+
Um caractere de espaço em branco (espaço, tabulação ou nova linha) precisa estar presente logo após
17+
<literal>&lt;?php</literal> para assegurar uma separação correta de tokens.
18+
Omitir este espaço resultará em erro de sintaxe.
19+
</para>
20+
21+
<para>
22+
O PHP também inclui a etiqueta <literal>&lt;?=</literal>
23+
que é um encurtamento para <code>&lt;?php echo</code>.
1924
</para>
2025

2126
<para>

Diff for: ‎reference/reflection/reflectionclass/setstaticpropertyvalue.xml

+35-5
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: ec2fe9a592f794978114ef5021db9f1d00c2e05d Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
2+
<!-- EN-Revision: c4aabaa0b97ef1ecc00cf2cd539ea186c6a855ae Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
33
<refentry xml:id="reflectionclass.setstaticpropertyvalue" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
44
<refnamediv>
55
<refname>ReflectionClass::setStaticPropertyValue</refname>
6-
<refpurpose>Define o valor da propriedade estática</refpurpose>
6+
<refpurpose>Define o valor da propriedade estática pública</refpurpose>
77
</refnamediv>
88

99
<refsect1 role="description">
@@ -13,9 +13,14 @@
1313
<methodparam><type>string</type><parameter>name</parameter></methodparam>
1414
<methodparam><type>mixed</type><parameter>value</parameter></methodparam>
1515
</methodsynopsis>
16-
<para>
17-
Define o valor da propriedade estática.
18-
</para>
16+
<simpara>
17+
Define o valor da propriedade estática pública.
18+
Se a propriedade for privada ou protegida, o método falhará.
19+
</simpara>
20+
<simpara>
21+
<methodname>ReflectionProperty::setValue</methodname> permite definir
22+
valores de propriedades públicas, privadas e protegidas.
23+
</simpara>
1924
</refsect1>
2025

2126
<refsect1 role="parameters">
@@ -49,11 +54,36 @@
4954
</para>
5055
</refsect1>
5156

57+
<refsect1 role="changelog">
58+
&reftitle.changelog;
59+
<informaltable>
60+
<tgroup cols="2">
61+
<thead>
62+
<row>
63+
<entry>&Version;</entry>
64+
<entry>&Description;</entry>
65+
</row>
66+
</thead>
67+
<tbody>
68+
<row>
69+
<entry>7.4.0</entry>
70+
<entry>
71+
Usar <methodname>ReflectionClass::setStaticPropertyValue</methodname> para definir
72+
uma propriedade privada ou protegida agora resulta em erro fatal. Anteriormente,
73+
lançava uma exceção <classname>ReflectionException</classname>.
74+
</entry>
75+
</row>
76+
</tbody>
77+
</tgroup>
78+
</informaltable>
79+
</refsect1>
80+
5281
<refsect1 role="seealso">
5382
&reftitle.seealso;
5483
<para>
5584
<simplelist>
5685
<member><methodname>ReflectionClass::getStaticPropertyValue</methodname></member>
86+
<member><methodname>ReflectionProperty::setValue</methodname></member>
5787
</simplelist>
5888
</para>
5989
</refsect1>

Diff for: ‎reference/reflection/reflectionproperty/setvalue.xml

+12-11
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 0a8a502764676759e213265a3e1e675c43533dd1 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
2+
<!-- EN-Revision: c4aabaa0b97ef1ecc00cf2cd539ea186c6a855ae Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
33

44
<refentry xml:id="reflectionproperty.setvalue" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
@@ -11,7 +11,7 @@
1111
&reftitle.description;
1212
<methodsynopsis role="ReflectionProperty">
1313
<modifier>public</modifier> <type>void</type><methodname>ReflectionProperty::setValue</methodname>
14-
<methodparam><type>object</type><parameter>object</parameter></methodparam>
14+
<methodparam><type class="union"><type>object</type><type>null</type></type><parameter>object</parameter></methodparam>
1515
<methodparam><type>mixed</type><parameter>value</parameter></methodparam>
1616
</methodsynopsis>
1717
<methodsynopsis>
@@ -23,7 +23,7 @@
2323
</para>
2424
<note>
2525
<simpara>
26-
A partir do PHP 8.3.0, chamar este método com um único argumento está descontinuado, use <methodname>ReflectionClass::setStaticPropertyValue</methodname> em seu lugar.
26+
Para definir valores de propriedades estáticas, use <literal>ReflectionProperty::setValue(null, $value)</literal>.
2727
</simpara>
2828
</note>
2929
</refsect1>
@@ -36,9 +36,8 @@
3636
<term><parameter>object</parameter></term>
3737
<listitem>
3838
<para>
39-
Se a propriedade não for estática, um objeto deverá ser fornecido para alterar
40-
a propriedade.
41-
Se a propriedade for estática, um valor &null; <emphasis>deve</emphasis> ser fornecido.
39+
Para propriedades estáticas, informe &null;.
40+
Para propriedades não estáticas, informe o objeto.
4241
</para>
4342
</listitem>
4443
</varlistentry>
@@ -76,8 +75,8 @@
7675
<entry>8.3.0</entry>
7776
<entry>
7877
Chamar este método com um único argumento está descontinuado,
79-
<methodname>ReflectionClass::setStaticPropertyValue</methodname>
80-
deve ser usado para modificar propriedades estáticas.
78+
use <literal>ReflectionProperty::setValue(null, $value)</literal>
79+
para propriedades estáticas.
8180
</entry>
8281
</row>
8382
<row>
@@ -112,8 +111,10 @@ class Foo {
112111
113112
$reflectionClass = new ReflectionClass('Foo');
114113
115-
// A partir do PHP 8.3, setValue não deve mais ser usado para definir o valor de propriedade estática, use setStaticPropertyValue() no lugar
116-
$reflectionClass->setStaticPropertyValue('staticProperty', 'foo');
114+
// A partir do PHP 8.3, passar null como primeiro argumento é necessário
115+
// para acessar propriedades estáticas.
116+
$reflectionProperty = $reflectionClass->getProperty('staticProperty');
117+
$reflectionProperty->setValue(null, 'foo');
117118
var_dump(Foo::$staticProperty);
118119
119120
$foo = new Foo;
@@ -122,7 +123,7 @@ $reflectionClass->getProperty('property')->setValue($foo, 'bar');
122123
var_dump($foo->property);
123124
124125
$reflectionProperty = $reflectionClass->getProperty('privateProperty');
125-
$reflectionProperty->setAccessible(true); // only required prior to PHP 8.1.0
126+
$reflectionProperty->setAccessible(true); // requerido apenas antes do PHP 8.1.0
126127
$reflectionProperty->setValue($foo, 'foobar');
127128
var_dump($reflectionProperty->getValue($foo));
128129
?>

0 commit comments

Comments
 (0)