sync with en rev

appendices/migration72/incompatible.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 6d29533483657c036e49edb5ea88c7103d126681 Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 8859c8b96cd9e80652813f7bcf561432a5e9f934 Maintainer: leonardolara Status: ready -->
 
 <sect1 xml:id="migration72.incompatible">
  <title>Alterações incompatíveis com versões anteriores</title>
@@ -46,7 +46,7 @@ var_dump(number_format(-0.01)); // now outputs string(1) "0" instead of string(2
 
 // array to object
 $arr = [0 => 1];
-$obj = (object)$arr;
+$obj = (object) $arr;
 var_dump(
     $obj,
     $obj->{'0'}, // agora acessível
@@ -84,7 +84,7 @@ $obj = new class {
         $this->{0} = 1;
     }
 };
-$arr = (array)$obj;
+$arr = (array) $obj;
 var_dump(
     $arr,
     $arr[0], // agora acessível

chapters/tutorial.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 08bce8d11d3d2a7d0461c17138d61b9da5be817a Maintainer: ae Status: ready --><!-- CREDITS: thomasgm,ae,adiel,leonardolara -->
+<!-- EN-Revision: 8859c8b96cd9e80652813f7bcf561432a5e9f934 Maintainer: ae Status: ready --><!-- CREDITS: thomasgm,ae,adiel,leonardolara -->
  <chapter xml:id="tutorial" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <info><title>Um simples tutorial</title></info>
 
@@ -398,7 +398,7 @@ if (str_contains($_SERVER['HTTP_USER_AGENT'], 'Firefox') !== false) {
      <programlisting role="php">
 <![CDATA[
 Hi <?php echo htmlspecialchars($_POST['name']); ?>.
-You are <?php echo (int)$_POST['age']; ?> years old.
+You are <?php echo (int) $_POST['age']; ?> years old.
 ]]>
      </programlisting>
      <para>

language/operators/bitwise.xml

@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 61374bbe228e8e9c55a24aba59a1e2bb2a871148 Maintainer: ae Status: ready --><!-- CREDITS: ae,leonardolara -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 8859c8b96cd9e80652813f7bcf561432a5e9f934 Maintainer: ae Status: ready --><!-- CREDITS: ae,leonardolara -->
 <sect1 xml:id="language.operators.bitwise">
  <title>Operadores Binários</title>
  <titleabbrev>Binários</titleabbrev>
@@ -243,10 +243,10 @@ echo "hallo" ^ "hello"; // Imprime os valores ASCII #0 #4 #0 #0 #0
                         // 'a' ^ 'e' = #4
 
 echo 2 ^ "3"; // Imprime 1
-              // 2 ^ ((int)"3") == 1
+              // 2 ^ ((int) "3") == 1
 
 echo "2" ^ 3; // Imprime 1
-              // ((int)"2") ^ 3 == 1
+              // ((int) "2") ^ 3 == 1
 ?>
 ]]>
    </programlisting>

language/operators/comparison.xml

@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 43d07782b514d0c7a8487f2c74063739f302df8d Maintainer: ae Status: ready -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 8859c8b96cd9e80652813f7bcf561432a5e9f934 Maintainer: ae Status: ready -->
 <sect1 xml:id="language.operators.comparison">
  <title>Operadores de Comparação</title>
  <titleabbrev>Comparação</titleabbrev>
@@ -266,11 +266,11 @@ echo $a <=> $b; // 1
 <![CDATA[
 <?php
 // Bool e null são sempre comparados como booleanos
-var_dump(1 == TRUE);  // TRUE - same as (bool)1 == TRUE
-var_dump(0 == FALSE); // TRUE - same as (bool)0 == FALSE
-var_dump(100 < TRUE); // FALSE - same as (bool)100 < TRUE
-var_dump(-10 < FALSE);// FALSE - same as (bool)-10 < FALSE
-var_dump(min(-100, -10, NULL, 10, 100)); // NULL - (bool)NULL < (bool)-100 is FALSE < TRUE
+var_dump(1 == TRUE);  // TRUE - same as (bool) 1 == TRUE
+var_dump(0 == FALSE); // TRUE - same as (bool) 0 == FALSE
+var_dump(100 < TRUE); // FALSE - same as (bool) 100 < TRUE
+var_dump(-10 < FALSE);// FALSE - same as (bool) -10 < FALSE
+var_dump(min(-100, -10, NULL, 10, 100)); // NULL - (bool) NULL < (bool) -100 is FALSE < TRUE
 ?>
 ]]>
    </programlisting>
@@ -421,7 +421,7 @@ echo (true ? 'true' : false ? 't' : 'f');
 echo ((true ? 'true' : false) ? 't' : 'f');
 
 // Aqui, é possível ver que a primeira expressão avalia para 'true', e então
-// é avalidada para (bool)true, e portanto retorna o variante true da
+// é avalidada para (bool) true, e portanto retorna o variante true da
 // segunda expressão ternária
 ?>
 ]]>

language/types/array.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c97d8be813dd0189f2a97359795fbe7173792878 Maintainer: ae Status: ready --><!-- CREDITS: felipe,fabioluciano,rogeriopradoj,geekcom,ae,gabrielsanva,leonardolara -->
+<!-- EN-Revision: 8859c8b96cd9e80652813f7bcf561432a5e9f934 Maintainer: ae Status: ready --><!-- CREDITS: felipe,fabioluciano,rogeriopradoj,geekcom,ae,gabrielsanva,leonardolara -->
 <sect1 xml:id="language.types.array">
  <title>Arrays</title>
 
@@ -965,7 +965,7 @@ $error_descriptions[8] = "Apenas um aviso informal";
    <type>string</type>, <type>bool</type> e <type>resource</type>,
    converter um valor para um <type>array</type>, resultará em um array com um único
    elemento com índice zero e valor escalar convertido. Em
-   outras palavras, <literal>(array)$scalarValue</literal> é exatamente o mesmo que
+   outras palavras, <code>(array) $scalarValue</code> é exatamente o mesmo que
    <literal>array($scalarValue)</literal>.
   </para>
 

language/types/integer.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: c09d80b942f41c7b9961a0773525ac8e1408daf2 Maintainer: fabioluciano Status: ready --><!-- CREDITS: felipe, fabioluciano, geekcom, github:lisaldo, gabrielsanva, adiel, marcosmarcolin, leonardolara -->
+<!-- EN-Revision: 8859c8b96cd9e80652813f7bcf561432a5e9f934 Maintainer: fabioluciano Status: ready --><!-- CREDITS: felipe, fabioluciano, geekcom, github:lisaldo, gabrielsanva, adiel, marcosmarcolin, leonardolara -->
 <sect1 xml:id="language.types.integer">
  <title>Inteiros</title>
 
@@ -200,7 +200,7 @@ var_dump(foo(8.1)); // "Descontinuado: conversão implícita de float 8.1 para i
 var_dump(foo(8.1)); // 8 antes do PHP 8.1.0
 var_dump(foo(8.0)); // 8 em ambos os casos
 
-var_dump((int)8.1); // 8 em ambos os casos
+var_dump((int) 8.1); // 8 em ambos os casos
 var_dump(intval(8.1)); // 8 em ambos os casos
 ?>
 ]]>

reference/array/functions/array-merge.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 9e0f03ac354d797d1d16c0fcc1663e5e170f2727 Maintainer: ae Status: ready --><!-- CREDITS: lucasr,felipe,ae,github:LPJFilho -->
+<!-- EN-Revision: 8859c8b96cd9e80652813f7bcf561432a5e9f934 Maintainer: ae Status: ready --><!-- CREDITS: lucasr,felipe,ae,github:LPJFilho -->
 <refentry xml:id="function.array-merge" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>array_merge</refname>
@@ -179,7 +179,7 @@ array(5) {
 <?php
 $beginning = 'foo';
 $end = array(1 => 'bar');
-$result = array_merge((array)$beginning, (array)$end);
+$result = array_merge((array) $beginning, (array) $end);
 print_r($result);
 ?>
 ]]>

reference/datetime/datetimeinterface/gettimestamp.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 71692b6f4cace8dca72a18ccd80d4cd7305e5d4e Maintainer: fabioluciano Status: ready --><!-- CREDITS: fabioluciano, leonardolara -->
+<!-- EN-Revision: 8859c8b96cd9e80652813f7bcf561432a5e9f934 Maintainer: fabioluciano Status: ready --><!-- CREDITS: fabioluciano, leonardolara -->
 <refentry xml:id="datetime.gettimestamp" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>DateTimeInterface::getTimestamp</refname>
@@ -118,8 +118,8 @@ echo date_timestamp_get($date);
    </screen>
   </example>
   <para>
-   Se você precisa recuperar o timestamp com resolução de
-   milissegundos ou microssegundos, você pode uitilizar a
+   Se for necessário recuperar o timestamp com resolução de
+   milissegundos ou microssegundos, pode ser utilizada a
    função <function>DateTimeInterface::format</function>.
   </para>
   <example>
@@ -129,8 +129,8 @@ echo date_timestamp_get($date);
 <![CDATA[
 <?php
 $date = new DateTimeImmutable();
-$mili = (int)$date->format('Uv'); // Timestamp em milissegundos
-$micro = (int)$date->format('Uu'); // Timestamp em microssegundos
+$mili = (int) $date->format('Uv'); // Timestamp em milissegundos
+$micro = (int) $date->format('Uu'); // Timestamp em microssegundos
 
 echo $mili, "\n", $micro, "\n";
 ?>

reference/rar/examples.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 257719873bb67162f68ad4d855d259745b02378b Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 8859c8b96cd9e80652813f7bcf561432a5e9f934 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
 
 <chapter xml:id="rar.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.examples;
@@ -56,7 +56,7 @@ function detectUserAgent() {
     if (preg_match("@Chrome/@", $uas))
         return "Chrome";
     if (preg_match("@MSIE ([0-9.]+);@", $uas, $matches)) {
-        if (((float)$matches[1]) >= 7.0)
+        if (((float) $matches[1]) >= 7.0)
             return "IE";
     }
 

reference/reflection/reflectionenum/getbackingtype.xml

@@ -1,5 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ec2fe9a592f794978114ef5021db9f1d00c2e05d Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 8859c8b96cd9e80652813f7bcf561432a5e9f934 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
 <refentry xml:id="reflectionenum.getbackingtype" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>ReflectionEnum::getBackingType</refname>
@@ -13,9 +12,9 @@
    <void/>
   </methodsynopsis>
   <para>
-   Se a enumeração for um Backed Enum, este método retornará uma instância
+   Se a enumeração for um apoiada, este método retornará uma instância
    de <classname>ReflectionType</classname> para o tipo de apoio do Enum.
-   Se não for um Backed Enum, retornará <literal>null</literal>.
+   Se não for apoiada, retornará <literal>null</literal>.
   </para>
 
  </refsect1>
@@ -29,7 +28,7 @@
   &reftitle.returnvalues;
   <para>
    Uma instância de <classname>ReflectionNamedType</classname> ou <literal>null</literal>
-   se o Enum não tiver tipo de apoio.
+   se a enumeração não tiver tipo de apoio.
   </para>
  </refsect1>
 
@@ -76,7 +75,7 @@ $rEnum = new ReflectionEnum(Suit::class);
 
 $rBackingType = $rEnum->getBackingType();
 
-var_dump((string)$rBackingType);
+var_dump((string) $rBackingType);
 ?>
 ]]>
     </programlisting>

reference/session/sessionhandlerinterface.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 62126c55f1c6ed444043e7272c4f9e233818a44b Maintainer: leonardolara Status: ready --><!-- CREDITS: marcosmarcolin, leonardolara -->
+<!-- EN-Revision: 8859c8b96cd9e80652813f7bcf561432a5e9f934 Maintainer: leonardolara Status: ready --><!-- CREDITS: marcosmarcolin, leonardolara -->
 <reference xml:id="class.sessionhandlerinterface" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
 
  <title>A classe SessionHandlerInterface</title>
@@ -48,21 +48,21 @@
      Exemplo usando <classname>SessionHandlerInterface</classname>
     </title>
     <para>
-     O exemplo a seguir apresenta um armazenamento de sessão baseada em arquivos semelhante aos
-     manipuladores de gravação de sessão padrões do PHP <parameter>files</parameter>.  Este
-     exemplo poderia ser facilmente estendido para cobrir armazenamento em banco de dados usando sua
-     engine de banco de dados favorita que seja suportada pelo PHP.
+     O exemplo a seguir fornece um armazenamento de sessão baseado em arquivos similar ao
+     manipulador de gravação padrão de sessões do PHP, <parameter>files</parameter>. Este
+     exemplo poderia facilmente ser estendido para cobrir armazenamento em banco de dados usando
+     o motor de banco de dados de sua preferência suportado pelo PHP.
     </para>
     <para>
-     Note que é usado orientação à objetos com <function>session_set_save_handler</function> e
-     a função de encerramento (register_shutdown) é registrada usando sua respectiva flag.  Isto é
-     aconselhável ao registrar objetos como manipuladores de gravação de sessão.
+     Observe que é usado o protótipo orientado a objetos com <function>session_set_save_handler</function> e
+     a função de encerramento (register_shutdown) é registrada usando a opção de parâmetro da função. Isto é
+     geralmente aconselhável ao registrar objetos como manipuladores de gravação de sessão.
     </para>
     <caution>
      <para>
       Por brevidade, este exemplo omite a validação de entrada. No entanto, o
-      Os parâmetros <literal>$id</literal> são, na verdade, valores fornecidos pelo usuário que
-      exigem validação/sanitização adequada para evitar vulnerabilidades, como
+      parâmetros <literal>$id</literal> são, na verdade, valores fornecidos pelo usuário que
+      exigem validação e sanitização adequadas para evitar vulnerabilidades, como
       problemas de passagem de caminho. <emphasis>Portanto, não use este exemplo não modificado em
       ambientes de produção.</emphasis>
      </para>
@@ -92,7 +92,7 @@ class MySessionHandler implements SessionHandlerInterface
     #[\ReturnTypeWillChange]
     public function read($id)
     {
-        return (string)@file_get_contents("$this->savePath/sess_$id");
+        return (string) @file_get_contents("$this->savePath/sess_$id");
     }
 
     public function write($id, $data): bool

reference/stream/functions/stream-notification-callback.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: aca589264ab655bb1505d01e1a6d34cda6ba3d53 Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 8859c8b96cd9e80652813f7bcf561432a5e9f934 Maintainer: leonardolara Status: ready -->
 
 <refentry xml:id="function.stream-notification-callback" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -222,7 +222,7 @@ function stream_notification_callback($notification_code, $severity, $message, $
             if (!isset($filesize)) {
                 printf("\rTamanho de arquivo desconhecido.. %2d kb concluídos..", $bytes_transferred/1024);
             } else {
-                $length = (int)(($bytes_transferred/$filesize)*100);
+                $length = (int) (($bytes_transferred/$filesize)*100);
                 printf("\r[%-100s] %d%% (%2d/%2d kb)", str_repeat("=", $length). ">", $length, ($bytes_transferred/1024), $filesize/1024);
             }
         }
@@ -248,10 +248,10 @@ exit(1);
 ]]>
     </programlisting>
     <para>
-     Executing the example above with:
+     Executando o exemplo acima com:
      <literal>php -n fetch.php
      http://no2.php.net/get/php-5-LATEST.tar.bz2/from/this/mirror
-     php-latest.tar.bz2</literal> will output something similar too:
+     php-latest.tar.bz2</literal> irá exibir algo parecido também:
     </para>
     <screen>
 <![CDATA[