sync with en rev

php · Nov 29, 2024 · da5f25d · da5f25d
1 parent 36e6963
commit da5f25d
Show file tree

Hide file tree

Showing 6 changed files with 120 additions and 27 deletions.
diff --git a/appendices/tokens.xml b/appendices/tokens.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 8a6397d39aefd23c61d64aa4e9af919772541e2a Maintainer: ae Status: ready --><!-- CREDITS: denisolvr,lcobucci,ae,adiel,lisaldo,royopa,leonardolara -->
+<!-- EN-Revision: 9418ae19ae6ab1d3f1536db986830362b207b1d6 Maintainer: ae Status: ready --><!-- CREDITS: denisolvr,lcobucci,ae,adiel,lisaldo,royopa,leonardolara -->
 
 <appendix xml:id="tokens" xmlns="http://docbook.org/ns/docbook">
  <title>Lista de Tokens do Analisador</title>
@@ -715,6 +715,13 @@ defined('T_FN') || define('T_FN', 10001);
       ganchos de propriedades (disponível a partir do PHP 8.4.0)
      </entry>
     </row>
+    <row xml:id="constant.t-property-c">
+     <entry><constant>T_PROPERTY_C</constant></entry>
+     <entry>__PROPERTY__</entry>
+     <entry>
+      <link linkend="language.constants.predefined">constantes mágicas</link>
+     </entry>
+    </row>
     <row xml:id="constant.t-protected">
      <entry><constant>T_PROTECTED</constant></entry>
      <entry>protected</entry>

diff --git a/language/constants.xml b/language/constants.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: f9dabdea3f92ea77cf5077020a3e945951fdc9db Maintainer: ae Status: ready --><!-- CREDITS: ae,thiago,lcobucci,fabioluciano,lisaldo,geekcom,gabrielsanva,leonardolara -->
+<!-- EN-Revision: 9418ae19ae6ab1d3f1536db986830362b207b1d6 Maintainer: ae Status: ready --><!-- CREDITS: ae,thiago,lcobucci,fabioluciano,lisaldo,geekcom,gabrielsanva,leonardolara -->
  <chapter xml:id="language.constants" xmlns="http://docbook.org/ns/docbook">
   <title>Constantes</title>
 
@@ -252,7 +252,7 @@ echo ANIMAIS[1]; // imprime "gato"
   <sect1 xml:id="language.constants.magic">
    <title>Constantes Mágicas</title>
    <para>
-    Existem nove constantes mágicas que mudam dependendo de
+    Existem algumas constantes mágicas que mudam dependendo de
     onde são usadas. Por exemplo, o valor de
     <constant>__LINE__</constant> depende da linha em que é
     usada no script. Todas essas constantes "mágicas" são resolvidas
@@ -303,8 +303,8 @@ echo ANIMAIS[1]; // imprime "gato"
         <entry>
          O nome da classe. O nome da classe inclui o namespace
          em que foi declarada (por exemplo, <literal>Foo\Bar</literal>).
-         Quando usada
-         em um método de trait, __CLASS__ é o nome da classe em que o trait
+         Quando usada dentro de um método de trait,
+         <constant>__CLASS__</constant> é o nome da classe em que o trait
          for usado.
         </entry>
        </row>
@@ -324,7 +324,9 @@ echo ANIMAIS[1]; // imprime "gato"
        <row xml:id="constant.property">
         <entry><constant>__PROPERTY__</constant></entry>
         <entry>
-         Válido somente dentro de um <link linkend="language.oop5.property-hooks">gancho de propriedade</link>. É igual ao nome da propriedade.
+         Válido somente dentro de um
+         <link linkend="language.oop5.property-hooks">gancho de propriedade</link>.
+         É igual ao nome da propriedade.
         </entry>
        </row>
        <row xml:id="constant.namespace">

diff --git a/language/oop5/constants.xml b/language/oop5/constants.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 0f9e74f907e38bf243d75e74aed42f281a88de40 Maintainer: ae Status: ready --><!-- CREDITS: narigone, felipe, ae, fabioluciano -->
+<!-- EN-Revision: 7ddc30e0d2087d75b8f50da40668f4e422c6a4c5 Maintainer: ae Status: ready --><!-- CREDITS: narigone, felipe, ae, fabioluciano, leonardolara -->
 <sect1 xml:id="language.oop5.constants" xmlns="http://docbook.org/ns/docbook">
  <title>Constantes de Classe</title>
  <para>
@@ -120,10 +120,42 @@ Fatal error: Uncaught Error: Cannot access private const Foo::BAZ in …
    Modificadores de visibilidade estão disponíveis desde o PHP 7.1.0.
   </para>
  </note>
+ <example>
+  <title>Verificando variância de visibilidade de constantes de classe, a partir do PHP 8.3.0</title>
+  <programlisting role="php">
+<![CDATA[
+<?php
+
+interface MyInterface
+{
+    public const VALUE = 42;
+}
+
+class MyClass implements MyInterface
+{
+    protected const VALUE = 42;
+}
+?>
+]]>
+  </programlisting>
+  &example.outputs.83;
+  <screen>
+<![CDATA[
+Fatal error: Access level to MyClass::VALUE must be public (as in interface MyInterface) …
+]]>
+  </screen>
+ </example>
+ <note>
+  <simpara>
+   A partir do PHP 8.3.0, a variância de visibilidade é verificada mais estritamente.
+   Antes desta versão, a visibilidade de uma constante de classe poderia ser diferente
+   da visibilidade da constante na interface implementada.
+  </simpara>
+ </note>
  <example>
   <title>Sintaxe de busca de constante de classe, a partir do PHP 8.3.0</title>
   <programlisting role="php">
-   <![CDATA[
+<![CDATA[
 <?php
 class Foo {
     public const BAR = 'bar';

diff --git a/language/oop5/traits.xml b/language/oop5/traits.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 88918fd70320eb65383618a0ce263d0a95d64f5b Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<!-- EN-Revision: c1c803cf6a83feb30a444c90787c88cd1946e3f6 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
  <sect1 xml:id="language.oop5.traits" xmlns="http://docbook.org/ns/docbook">
   <title>Traits</title>
   <para>
@@ -423,6 +423,13 @@ Example::doSomething();
    </example>
    <example xml:id="language.oop5.traits.static.ex3">
     <title>Propriedades Estáticas</title>
+    <caution>
+     <simpara>
+      Antes do PHP 8.3.0, propriedades estáticas eram compartilhadas por todas as classes
+      que usavam o trait. A partir do PHP 8.3.0, cada classe que usa o trait tem sua
+      própria cópia da propriedade estática.
+     </simpara>
+    </caution>
     <programlisting role="php">
      <![CDATA[
 <?php

diff --git a/language/types/array.xml b/language/types/array.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 8859c8b96cd9e80652813f7bcf561432a5e9f934 Maintainer: ae Status: ready --><!-- CREDITS: felipe,fabioluciano,rogeriopradoj,geekcom,ae,gabrielsanva,leonardolara -->
+<!-- EN-Revision: cb3794f501ce55cedc40125fb995018bdc4ac1d1 Maintainer: ae Status: ready --><!-- CREDITS: felipe,fabioluciano,rogeriopradoj,geekcom,ae,gabrielsanva,leonardolara -->
 <sect1 xml:id="language.types.array">
  <title>Arrays</title>
 
@@ -316,6 +316,57 @@ array(7) {
 ]]>
     </screen>
    </example>
+
+   <example>
+    <title>Exemplo de índice negativo</title>
+    <simpara>
+     Ao atribuir uma chave inteira negativa <literal>n</literal>, o PHP irá
+     atribuir <literal>n+1</literal> à chave seguinte.
+    </simpara>
+    <programlisting role="php">
+     <![CDATA[
+<?php
+$array = [];
+
+$array[-5] = 1;
+$array[] = 2;
+
+var_dump($array);
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+     <![CDATA[
+array(2) {
+  [-5]=>
+  int(1)
+  [-4]=>
+  int(2)
+}
+]]>
+    </screen>
+
+    <warning>
+     <simpara>
+      Antes do PHP 8.3.0, atribuir um a chave inteira negativa <literal>n</literal> causaria
+      a atribuição de <literal>0</literal> à chave seguinte, portando o exemplo anterior
+      teria este resultado:
+     </simpara>
+     <informalexample>
+      <screen>
+<![CDATA[
+array(2) {
+  [-5]=>
+  int(1)
+  [0]=>
+  int(2)
+}
+]]>
+      </screen>
+     </informalexample>
+    </warning>
+   </example>
   </sect3>
 
   <sect3 xml:id="language.types.array.syntax.accessing">

diff --git a/reference/password/constants.xml b/reference/password/constants.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c6532951edb85836f2d49a3c81f8f5e1e41d3554 Maintainer: ae Status: ready --><!-- CREDITS: rogeriopradoj,ae,leonardolara -->
+<!-- EN-Revision: 3010cc4a09e572e8a378934843af1aabeb6273b2 Maintainer: ae Status: ready --><!-- CREDITS: rogeriopradoj,ae,leonardolara -->
 
 <appendix xml:id="password.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.constants;
@@ -177,7 +177,7 @@
    <varlistentry xml:id="constant.password-default">
     <term>
      <constant>PASSWORD_DEFAULT</constant>
-     (<type>mixed</type>)
+     (<type>string</type>)
     </term>
     <listitem>
      <para>
@@ -186,22 +186,16 @@
       fortes forem suportados.
      </para>
      <para>
-      É importante notar que ao longo do tempo essa constante pode (e provavelmente vai)
-      mudar. Assim sendo, deve-se estar ciente que o comprimento do hash resultante
-      pode mudar. Portanto, se <constant>PASSWORD_DEFAULT</constant> for usada,
-      deve-se armazenar o hash resultante de um modo que possa armazenar mais de 60
-      caracteres (255 é o comprimento recomendado).
-     </para>
-     <para>
-      Valores para esta constante:
+      É importante notar que ao longo do tempo essa constante pode mudar.
+      Assim sendo, deve-se estar ciente que o comprimento do hash resultante
+      pode mudar.
+      Portanto, ao usar <constant>PASSWORD_DEFAULT</constant>, o hash
+      resultante deve ser armazanado de uma forma que possa armazenar hashes arbitrários,
+      o comprimento recomendado é de <literal>255</literal> bytes.
      </para>
-     <itemizedlist>
-      <listitem>
-       <simpara>
-        PHP 5.5.0 - <constant>PASSWORD_BCRYPT</constant>
-       </simpara>
-      </listitem>
-     </itemizedlist>
+     <simpara>
+      Atualmente é um sinônimo de <constant>PASSWORD_BCRYPT</constant>.
+     </simpara>
     </listitem>
    </varlistentry>
   </variablelist>