Merge branch 'master' into update-migration83-other-changes-11-2023

php · Nov 28, 2023 · ead602d · ead602d
2 parents bda3988 + 7c18e3a
commit ead602d
Show file tree

Hide file tree

Showing 180 changed files with 8,041 additions and 5,197 deletions.
diff --git a/appendices/migration83/other-changes.xml b/appendices/migration83/other-changes.xml
@@ -163,7 +163,7 @@
 
    <para>
     <methodname>DOMDocument::loadHTML</methodname>,
-    <methodname>DOMDocument::loadHTMLFile</methodname>, e
+    <methodname>DOMDocument::loadHTMLFile</methodname> e
     <methodname>DOMDocument::loadXML</methodname> agora têm um tipo de retorno
     tentativo de <type>bool</type>. Anteriormente, isso estava documentado com um tipo de retorno
     de <code>DOMDocument|bool</code>, mas, a partir do PHP 8.0.0,

diff --git a/chapters/tutorial.xml b/chapters/tutorial.xml
@@ -298,7 +298,7 @@ Você está usando o Firefox.
     o PHP e busca uma palavra em outra palavra. Neste caso nós estamos
     procurando pelo texto <literal>'Firefox'</literal> dentro de
     <varname>$_SERVER['HTTP_USER_AGENT']</varname>. Se o dado pesquisado
-    for encontrado na coleção, a função retorna &true;. Se não, ela
+    for encontrado na coleção, a função retorna verdadeiro. Se não, ela
     retorna &false;. Se ela retornar &true;, o <link
     linkend="control-structures.if">if</link> avalia para &true;
     e o código dentro dos {colchetes} é executado. Caso contrário o código não

diff --git a/language/oop5/changelog.xml b/language/oop5/changelog.xml
@@ -3,9 +3,8 @@
 <sect1 xml:id="language.oop5.changelog" xmlns="http://docbook.org/ns/docbook">
  <title>Lista de alterações da POO</title>
  <para>
-  As alterações no modelo de POO do PHP são registradas aqui.
-  Descrições e outras notas relacionadas a estes recursos estão documentadas na
-  documentação do modelo POO.
+  As alterações no modelo de POO do PHP são registradas aqui. Descrições e outras notas
+  relacionadas a estes recursos estão documentadas na documentação do modelo POO.
  </para>
  <para>
   <informaltable>
@@ -20,19 +19,13 @@
      <row>
       <entry>8.1.0</entry>
       <entry>
-       Adicionado: suporte ao modificador <modifier>final</modifier> para
-       constantes de classe.
-       Além disso, as constantes de interface agora são substituíveis por
-       padrão.
+       Adicionado: suporte ao modificador <modifier>final</modifier> para constantes de classe. Além disso, as constantes de interface agora são substituíveis por padrão.
       </entry>
      </row>
      <row>
       <entry>8.0.0</entry>
       <entry>
-       Adicionado: suporte ao operador
-       <link linkend="language.oop5.basic.nullsafe">nullsafe</link>
-       <emphasis>?-&gt;</emphasis> para acessar propriedades e métodos em
-       objetos que podem ser nulos.
+       Adicionado: suporte ao <link linkend="language.oop5.basic.nullsafe">operador nullsafe</link> <emphasis>?-&gt;</emphasis> para acessar propriedades e métodos em objetos que podem ser nulos.
       </entry>
      </row>
      <row>
@@ -45,12 +38,10 @@
      <row>
       <entry>7.4.0</entry>
       <entry>
-       Adicionado: suporte a covariância limitada de tipo de retorno e
-       contravariância de tipo de argumento.
-       O suporte completo à variância só estará disponível se o carregamento
-       automático for usado.
-       Dentro de um único arquivo, apenas referências de tipo não cíclicas são
-       possíveis.
+       Adicionado: suporte a covariância limitada de tipo de retorno e contravariância
+       de tipo de argumento. O suporte completo à variância só estará disponível se o
+       carregamento automático for usado. Dentro de um único arquivo, apenas
+       referências de tipo não cíclicas são possíveis.
       </entry>
      </row>
      <row>
@@ -64,8 +55,7 @@
       <entry>
        Incompatibilidade: o desempacotamento de argumentos com instâncias de
        <classname>Traversable</classname> com chaves não-&integer; não é mais
-       suportado.
-       Esse comportamento não era intencional e, portanto, foi removido.
+       suportado. Esse comportamento não era intencional e, portanto, foi removido.
       </entry>
      </row>
      <row>
@@ -78,16 +68,15 @@
      <row>
       <entry>7.3.0</entry>
       <entry>
-       Alterado: o operador
-       <link linkend="language.operators.type">instanceof</link>
+       Alterado: o operador <link linkend="language.operators.type">instanceof</link>
        agora permite literais como o primeiro operando, caso em que o resultado
        é sempre &false;.
       </entry>
      </row>
      <row>
       <entry>7.2.0</entry>
       <entry>
-       Obsoleto: a função <function>__autoload</function> tornou-se obsoleta em
+       Defasado: a função <function>__autoload</function> tornou-se obsoleta em
        favor da função <function>spl_autoload_register</function>.
       </entry>
      </row>
@@ -137,16 +126,14 @@
      <row>
       <entry>7.0.0</entry>
       <entry>
-       Obsoleto: chamadas
-       <link linkend="language.oop5.static">estáticas</link>
+       Defasado: chamadas <link linkend="language.oop5.static">estáticas</link>
        a métodos que não são declarados estáticos.
       </entry>
      </row>
      <row>
       <entry>7.0.0</entry>
       <entry>
-       Obsoleto:
-       <link linkend="language.oop5.decon">construtor</link>
+       Defasado: <link linkend="language.oop5.decon">construtor</link>
        no estilo do PHP 4.
        Ou seja, métodos com o mesmo nome da classe em que eles são definidos.
       </entry>
@@ -186,39 +173,32 @@
      <row>
       <entry>5.6.0</entry>
       <entry>
-       Adicionado: o método
-       <link linkend="object.debuginfo">__debugInfo()</link>.
+       Adicionado: o método <link linkend="object.debuginfo">__debugInfo()</link>.
       </entry>
      </row>
      <row>
       <entry>5.5.0</entry>
       <entry>
-       Adicionado: a constante mágica
-       <link linkend="language.oop5.basic.class.class">::class</link>.
+       Adicionado: a constante mágica <link linkend="language.oop5.basic.class.class">::class</link>.
       </entry>
      </row>
      <row>
       <entry>5.5.0</entry>
       <entry>
-       Adicionado:
-       <link linkend="language.exceptions">finally</link>
-       para manipular exceções.
+       Adicionado: <link linkend="language.exceptions">finally</link> para manipular exceções.
       </entry>
      </row>
      <row>
       <entry>5.4.0</entry>
       <entry>
-       Adicionado:
-       <link linkend="language.oop5.traits">traits</link>.
+       Adicionado: <link linkend="language.oop5.traits">traits</link>.
       </entry>
      </row>
      <row>
       <entry>5.4.0</entry>
       <entry>
-       Alterado: se uma classe
-       <link linkend="language.oop5.abstract">abstract</link>
-       definir uma assinatura para o
-       <link linkend="language.oop5.decon">construtor</link>,
+       Alterado: se uma classe <link linkend="language.oop5.abstract">abstrata</link>
+       definir uma assinatura para o <link linkend="language.oop5.decon">construtor</link>,
        agora ela será imposta.
       </entry>
      </row>
@@ -245,19 +225,16 @@
       <entry>
        Alterado: agora é possível referenciar a classe usando uma variável
        (por exemplo, <literal>echo $nome_da_classe::CONSTANTE;</literal>).
-       O valor da variável não pode ser uma palavra-chave (por exemplo,
-       <literal>self</literal>,
+       O valor da variável não pode ser uma palavra-chave (por exemplo, <literal>self</literal>,
        <literal>parent</literal> ou <literal>static</literal>).
       </entry>
      </row>
      <row>
       <entry>5.3.0</entry>
       <entry>
        Alterado: um erro de nível <constant>E_WARNING</constant> será emitido se
-       os métodos mágicos de
-       <link linkend="language.oop5.overloading">sobrecarga</link>
-       forem declarados
-       <link linkend="language.oop5.static">estáticos</link>.
+       os métodos mágicos de <link linkend="language.oop5.overloading">sobrecarga</link>
+       forem declarados <link linkend="language.oop5.static">estáticos</link>.
        Também impõe o requisito de visibilidade pública.
       </entry>
      </row>
@@ -266,94 +243,76 @@
       <entry>
        Alterado: antes do PHP 5.3.0, as exceções lançadas na função
        <function>__autoload</function> não podiam ser capturadas no bloco
-       <link linkend="language.exceptions">catch</link>
-       e resultariam em um erro fatal.
-       Agora as exceções lançadas na função <function>__autoload</function>
-       podem ser capturadas no bloco
-       <link linkend="language.exceptions">catch</link>,
-       com uma condição.
-       Se uma exceção personalizada for lançada, a classe de exceção
-       personalizada deve estar disponível.
-       A função <function>__autoload</function> pode ser usada recursivamente
+       <link linkend="language.exceptions">catch</link> e resultariam em um
+       erro fatal. Agora as exceções lançadas na função __autoload podem ser
+       capturadas no bloco <link linkend="language.exceptions">catch</link>,
+       com uma condição. Se uma exceção personalizada for lançada, a classe de exceção
+       personalizada deve estar disponível. A função __autoload pode ser usada recursivamente
        para carregar automaticamente a classe de exceção personalizada.
       </entry>
      </row>
      <row>
       <entry>5.3.0</entry>
       <entry>
-       Adicionado: o método
-       <link linkend="language.oop5.overloading">__callStatic</link>.
+       Adicionado: o método <link linkend="language.oop5.overloading">__callStatic</link>.
       </entry>
      </row>
      <row>
       <entry>5.3.0</entry>
       <entry>
-       Adicionado: suporte a
-       <link linkend="language.types.string.syntax.heredoc">heredoc</link>
-       e
-       <link linkend="language.types.string.syntax.nowdoc">nowdoc</link>
-       nas definições de <emphasis>constantes</emphasis> e propriedades
-       de classe.
+       Adicionado: suporte a <link linkend="language.types.string.syntax.heredoc">heredoc</link>
+       e <link linkend="language.types.string.syntax.nowdoc">nowdoc</link>
+       nas definições de <emphasis>constantes</emphasis> e propriedades de classe.
        Nota: os valores heredoc devem seguir as mesmas regras que strings com
        aspas duplas, (por exemplo, sem variáveis dentro).
       </entry>
      </row>
      <row>
       <entry>5.3.0</entry>
       <entry>
-       Adicionado:
-       <link linkend="language.oop5.late-static-bindings">Late Static Bindings</link>.
+       Adicionado: <link linkend="language.oop5.late-static-bindings">Late Static Bindings</link>.
       </entry>
      </row>
      <row>
       <entry>5.3.0</entry>
       <entry>
-       Adicionado: o método
-       <link linkend="object.invoke">__invoke()</link>.
+       Adicionado: o método <link linkend="object.invoke">__invoke()</link>.
       </entry>
      </row>
      <row>
       <entry>5.2.0</entry>
       <entry>
-       Alterado: o método
-       <link linkend="object.tostring">__toString()</link>
+       Alterado: o método <link linkend="object.tostring">__toString()</link>
        só era chamado quando combinado diretamente com
        <function>echo</function> ou <function>print</function>.
        Mas agora, ele é chamado em qualquer contexto de &string; (por exemplo,
-       em <function>printf</function> com o modificador <literal>%s</literal>),
-       mas não em outros contextos de tipos (por exemplo, com o modificador
-       <literal>%d</literal>).
-       A partir do PHP 5.2.0, a conversão de &object;s sem um método
-       <link linkend="object.tostring">__toString</link>
-       para &string; emitirá um erro de nível
-       <constant>E_RECOVERABLE_ERROR</constant>.
+       em <function>printf</function> com o modificador <literal>%s</literal>), mas não
+       em outros contextos de tipos (por exemplo, com o modificador <literal>%d</literal>).
+       A partir do PHP 5.2.0, a conversão de &object;s sem um
+       método <link linkend="object.tostring">__toString</link> para &string;
+       emitirá um erro de nível <constant>E_RECOVERABLE_ERROR</constant>.
       </entry>
      </row>
      <row>
       <entry>5.1.3</entry>
       <entry>
-       Alterado: nas versões anteriores do PHP 5, o uso de
-       <literal>var</literal> era considerado obsoleto e emitiria um erro de
-       nível <constant>E_STRICT</constant>.
-       Agora não é mais obsoleto, portanto não emite o erro.
+       Alterado: nas versões anteriores do PHP 5, o uso de <literal>var</literal>
+       era considerado defasado e emitiria um erro de nível <constant>E_STRICT</constant>.
+       Agora não é mais defasado, portanto não emite o erro.
       </entry>
      </row>
      <row>
       <entry>5.1.0</entry>
       <entry>
-       Alterado: o método estático
-       <link linkend="object.set-state">__set_state()</link>
-       agora é chamado por classes exportadas com a função
-       <function>var_export</function>.
+       Alterado: o método estático <link linkend="object.set-state">__set_state()</link>
+       agora é chamado por classes exportadas com a função <function>var_export</function>.
       </entry>
      </row>
      <row>
       <entry>5.1.0</entry>
       <entry>
-       Adicionado: os métodos
-       <link linkend="object.isset">__isset()</link>
-       e
-       <link linkend="object.unset">__unset()</link>.
+       Adicionado: os métodos <link linkend="object.isset">__isset()</link>
+       e <link linkend="object.unset">__unset()</link>.
       </entry>
      </row>
     </tbody>

diff --git a/language/predefined/internaliterator/valid.xml b/language/predefined/internaliterator/valid.xml
@@ -24,7 +24,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Retorna &true; se a posição atual é válida, &false; se inválida.
+   Retorna verdadeiro se a posição atual é válida, falso se inválida.
   </para>
  </refsect1>
 </refentry>

diff --git a/language/types/float.xml b/language/types/float.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: d494ffa4d9f83b60fe66972ec2c0cf0301513b4a Maintainer: ae Status: ready --><!-- CREDITS: felipe,ae,fabioluciano,geekcom,lisaldo,lhsazevedo -->
+<!-- EN-Revision: a1e3d629b4f01ee41bd38391cd5c6ae5ee894cb3 Maintainer: ae Status: ready --><!-- CREDITS: felipe,ae,fabioluciano,geekcom,lisaldo,lhsazevedo,leonardolara -->
 <sect1 xml:id="language.types.float" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Números de ponto flutuante</title>
 
@@ -29,7 +29,7 @@ $d = 1_234.567; // a partir do PHP 7.4.0
   <programlisting>
 <![CDATA[
 LNUM          [0-9]+(_[0-9]+)*
-DNUM          ([0-9]*(_[0-9]+)*[\.]{LNUM}) | ({LNUM}[\.][0-9]*(_[0-9]+)*)
+DNUM          ({LNUM}?"."{LNUM}) | ({LNUM}"."{LNUM}?)
 EXPONENT_DNUM (({LNUM} | {DNUM}) [eE][+-]? {LNUM})
 ]]>
   </programlisting>