sync with en rev

Author: leonardolara

faq/using.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: aab33d644359aba597e810e2fc0c0caa0d347c9c Maintainer: ae Status: ready --><!-- CREDITS: marcelgsantos,lcobucci,ae,geekcom,adiel -->
+<!-- EN-Revision: 1709768e97fce7848c62aa2bf988419527bd1e8e Maintainer: leonardolara Status: ready --><!-- CREDITS: marcelgsantos,lcobucci,ae,geekcom,adiel,leonardolara -->
 <chapter xml:id="faq.using" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <title>Utilizando o PHP</title>
   <titleabbrev>Utilizando o PHP</titleabbrev>
@@ -12,7 +12,6 @@
   <qandaset>
 
    <qandaentry xml:id="faq.using.parameterorder">
-    <!-- TODO: Mention named arguments -->
     <question>
      <para>
       Não consigo me lembrar da ordem dos parâmetros das funções PHP. Eles são aleatórios?
@@ -29,6 +28,10 @@
       <link linkend="book.strings">funções de String</link> são o contrário,
       logo "<emphasis>haystack, needle</emphasis>".
      </para>
+     <para>
+      A partir do PHP 8.0, <link linkend="functions.named-arguments">argumentos nomeados</link>
+      permitem a passagem de argumentos pelo nome do parâmetro, tornando a ordem dos parâmetros menos significante.
+     </para>
     </answer>
    </qandaentry>
 
@@ -43,9 +46,9 @@
      <para>
       O PHP disponibiliza muitas <link linkend="language.variables.predefined">
       variáveis predefinidas</link>, como a superglobal <varname>$_POST</varname>.
-      Você pode iterar através de <varname>$_POST</varname>, já que ele é um array
+      É possível iterar por <varname>$_POST</varname>, já que ela é um array
       associativo com todos os valores enviados com o método POST. Por exemplo, vamos
-      iterar através de POST com &foreach;,
+      iterar por ela com &foreach;,
       verificar se há valores vazios com <function>empty</function>
       e imprimi-los na tela.
       <programlisting role="php">
@@ -79,7 +82,6 @@ if (empty($empty)) {
    </qandaentry>
 
    <qandaentry xml:id="faq.using.addslashes">
-    <!-- TODO Probably should mention not doing this... -->
     <question>
      <para>
       Preciso converter todas as aspas simples (') para uma barra invertida
@@ -98,6 +100,12 @@ if (empty($empty)) {
       <function>stripslashes</function>, que são mais comuns
       com códigos PHP antigos.
      </para>
+     <para>
+      Escapar valor manualmente é passível de erros e depende do contexto.
+      Prefira o uso de APIs de banco de dados que suportem instruções preparadas e
+      vinculação de parâmetros em vez de construir consultas por concatenação
+      de strings escapadas.
+     </para>
     </answer>
    </qandaentry>
 
@@ -118,7 +126,7 @@ echo "myfunc($variable) = " . myfunc($variable);
 ?>
 ]]>
     </programlisting>
-     o que está acontecendo?
+     O que está acontecendo?
      </para>
     </question>
     <answer>

reference/network/functions/setcookie.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: b41e78e6237f3fd9bcdaff42b98954b8fe40e5fe Maintainer: leonardolara Status: ready --><!-- CREDITS: adiel,thiago,ae,leonardolara -->
+<!-- EN-Revision: 6122a8317ca0068fc71f6a5167e0a2d99166ec7c Maintainer: leonardolara Status: ready --><!-- CREDITS: adiel,thiago,ae,leonardolara -->
 <refentry xml:id="function.setcookie" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>setcookie</refname>
@@ -237,18 +237,18 @@
       </entry>
      </row>
      <row>
-      <entry>7.3.0</entry>
+      <entry>8.0.0</entry>
       <entry>
-       Uma assinatura alternativa para suportar o array <parameter>options</parameter>
-       foi adicionado. Essa assinatura também permite configurar o atributo
-       SameSite do cookie.
+       Passar chaves não suportadas agora lança um <exceptionname>ValueError</exceptionname>
+       em vez de emitir um <constant>E_WARNING</constant>.
       </entry>
      </row>
      <row>
-      <entry>8.0.0</entry>
+      <entry>7.3.0</entry>
       <entry>
-       Passar chaves não suportadas agora lança um <exceptionname>ValueError</exceptionname>
-       em vez de emitir um <constant>E_WARNING</constant>.
+       Uma assinatura alternativa para suportar o array <parameter>options</parameter>
+       foi adicionado. Essa assinatura também permite configurar o atributo
+       SameSite do cookie.
       </entry>
      </row>