sync with en rev

php · Jan 4, 2025 · e2747c2 · e2747c2
1 parent 2124037
commit e2747c2
Show file tree

Hide file tree

Showing 19 changed files with 128 additions and 65 deletions.
diff --git a/appendices/ini.core.xml b/appendices/ini.core.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 565582ac3739b56c81ee0206aac9c994ca9fdb5e Maintainer: ae Status: ready --><!-- CREDITS: ae,fibbarth,fabioluciano,rogeriopradoj,adiel,geekcom,rafaelbernard,leonardolara -->
+<!-- EN-Revision: 90787fda14dcb0976a9738423e6c6013c037d048 Maintainer: leonardolara Status: ready --><!-- CREDITS: ae,fibbarth,fabioluciano,rogeriopradoj,adiel,geekcom,rafaelbernard,leonardolara -->
 
  <section xml:id="ini.core" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <title>Descrição das principais diretivas do &php.ini;</title>
@@ -1499,14 +1499,14 @@ include_path = ".:${USER}/pear/php"
      <varlistentry xml:id="ini.cgi.rfc2616-headers">
       <term>
        <parameter>cgi.rfc2616_headers</parameter>
-       <type>int</type>
+       <type>bool</type>
       </term>
       <listitem>
       <para>
         Indica ao PHP qual o tipo de headers usar ao enviar o código de resposta
-        HTTP. Se configurada para 0, o PHP envia um header "Status:" da <link xlink:href="&url.rfc;3875">RFC 3875</link>
+        HTTP. Se estiver desabilitada, o PHP envia um header "Status:" da <link xlink:href="&url.rfc;3875">RFC 3875</link>
         que é suportado pelo Apache e outros servidores web. Quando esta opção
-        é configurada para 1, o PHP enviará headers em conformidade com a
+        é habilitada, o PHP enviará headers em conformidade com a
         <link xlink:href="&url.rfc;2616">RFC 2616</link>.
        </para>
        <para>
@@ -1516,23 +1516,23 @@ include_path = ".:${USER}/pear/php"
         deve ser usado header("Status: 404 Not Found");.
        </para>
        <para>
-        Deixe-a configurada para 0 a não ser que saiba exatamente o que está fazendo.
+        Deixe-a desabilitada a não ser que saiba exatamente o que está fazendo.
        </para>
       </listitem>
      </varlistentry>
 
      <varlistentry xml:id="ini.fastcgi.impersonate">
       <term>
        <parameter>fastcgi.impersonate</parameter>
-       <type>string</type>
+       <type>bool</type>
       </term>
       <listitem>
        <para>
         O FastCGI rodando no IIS (em sistemas baseados em WINNT) suporta a habilidade de representar
         os tokens de segurança do cliente que faz a requisição. Isso permite ao IIS definir o
         contexto de segurança no qual a requisição executa. O mod_fastcgi rodando no Apache
         atualmente não suporta esta funcionalidade (17/03/2002)
-        Configure para 1 ao rodar no ISS. O padrão é zero.
+        Habilite ao rodar no ISS. O padrão é desabilitado.
        </para>
       </listitem>
      </varlistentry>

diff --git a/features/commandline.xml b/features/commandline.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4b4292baf79bb650763e8230dbb254ee59d5ce80 Maintainer: ae Status: ready --><!-- CREDITS: ThamaraHessel,pauloelr,royopa,ae,geekcom,leonardolara -->
+<!-- EN-Revision: 74ba8fee2972b6ba4f955392d760dea54e757a95 Maintainer: leonardolara Status: ready --><!-- CREDITS: ThamaraHessel,pauloelr,royopa,ae,geekcom,leonardolara -->
 <chapter xml:id="features.commandline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Usando PHP a partir da linha de comando</title>
  <titleabbrev>Uso da linha de Comando</titleabbrev>
@@ -182,6 +182,27 @@
            array <varname>$_SERVER</varname>, por exemplo:
            <varname>$_SERVER['argv']</varname>.
           </para>
+          <warning>
+           <para>
+            A presença de <varname>$argv</varname> ou <varname>$_SERVER['argv']</varname>
+            não é uma indicação confiável de que um script está sendo executado da
+            linha de comando porque elas podem ser definidas em outros contextos quando
+            <link linkend="ini.register-argc-argv">register_argc_argv</link> está habilitada.
+            O valor retornado por <function>php_sapi_name</function> é o que deve ser
+            verificado.
+            <informalexample>
+             <programlisting role="php">
+<![CDATA[
+<?php
+
+if (php_sapi_name() === 'cli') {
+    echo "Este script está sendo executando da linha de comando!\n";
+}
+]]>
+             </programlisting>
+            </informalexample>
+           </para>
+          </warning>
           </entry>
          </row>
          <row>

diff --git a/language/oop5/property-hooks.xml b/language/oop5/property-hooks.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c925e1a0ce0659ee1c12d80f9a4a58b10cc4222f Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 38ee859fa546db84a0a439420941a94ae49351fb Maintainer: leonardolara Status: ready -->
 <sect1 xml:id="language.oop5.property-hooks" xmlns="http://docbook.org/ns/docbook">
  <title>Ganchos de Propriedade</title>
 
@@ -196,7 +196,7 @@ class Example
    ou um 'set' curto com um tipo explícito, ou assim por diante, é válido.
   </simpara>
   <simpara>
-   Em uma propriedade apoiada, omitir um gancho <literal>get</literal> ou<literal>set</literal>
+   Em uma propriedade apoiada, omitir um gancho <literal>get</literal> ou <literal>set</literal>
    significa que o comportamento padrão de leitura ou gravação será usado.
   </simpara>
   <note>

diff --git a/language/predefined/variables/argv.xml b/language/predefined/variables/argv.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 660a9ebe1fc4ae3a32104381090f70bce652ee75 Maintainer: lhsazevedo Status: ready --><!-- CREDITS: felipe,fabioluciano,lhsazevedo -->
+<!-- EN-Revision: 74ba8fee2972b6ba4f955392d760dea54e757a95 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe,fabioluciano,lhsazevedo,leonardolara -->
 
 <refentry role="variable" xml:id="reserved.variables.argv" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -25,13 +25,21 @@
     está habilitada.
    </simpara>
   </note>
+  <warning>
+   <simpara>
+    Para testar se um script está sendo executado a partir da linha de
+    comando, <function>php_sapi_name</function> deve ser usada
+    em vez de verificar se <varname>$argv</varname> ou
+    <varname>$_SERVER['argv']</varname> estão definidas.
+   </simpara>
+  </warning>
  </refsect1>
 
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
    <example xml:id="variable.argv.basic">
-    <title>Exemplo da <varname>$argv</varname></title>
+    <title>Exemplo de <varname>$argv</varname></title>
     <programlisting role="php">
 <![CDATA[
 <?php

diff --git a/reference/array/functions/array-column.xml b/reference/array/functions/array-column.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 8cdc6621f9826d04abc3e50438c010804d7e8683 Maintainer: lhsazevedo Status: ready --><!-- CREDITS: fabioluciano,lhsazevedo -->
+<!-- EN-Revision: 8bf3587d8f70239a65d9aa44d42ced8a696a3e86 Maintainer: leonardolara Status: ready --><!-- CREDITS: fabioluciano,lhsazevedo,leonardolara -->
 <refentry xml:id="function.array-column" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>array_column</refname>
@@ -104,32 +104,34 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-// Array representing a possible record set returned from a database
-$records = array(
-    array(
+
+// Array representando um possível resultado retornado de um banco de dados
+$records = [
+    [
         'id' => 2135,
         'first_name' => 'John',
         'last_name' => 'Doe',
-    ),
-    array(
+    ],
+    [
         'id' => 3245,
         'first_name' => 'Sally',
         'last_name' => 'Smith',
-    ),
-    array(
+    ],
+    [
         'id' => 5342,
         'first_name' => 'Jane',
         'last_name' => 'Jones',
-    ),
-    array(
+    ],
+    [
         'id' => 5623,
         'first_name' => 'Peter',
         'last_name' => 'Doe',
-    )
-);
+    ]
+];
 
 $first_names = array_column($records, 'first_name');
 print_r($first_names);
+
 ?>
 ]]>
     </programlisting>
@@ -155,9 +157,34 @@ Array
     <programlisting role="php">
 <![CDATA[
 <?php
-// Using the $records array from Example #1
+
+// Usando o array $records do Exemplo #1
+$records = [
+    [
+        'id' => 2135,
+        'first_name' => 'John',
+        'last_name' => 'Doe',
+    ],
+    [
+        'id' => 3245,
+        'first_name' => 'Sally',
+        'last_name' => 'Smith',
+    ],
+    [
+        'id' => 5342,
+        'first_name' => 'Jane',
+        'last_name' => 'Jones',
+    ],
+    [
+        'id' => 5623,
+        'first_name' => 'Peter',
+        'last_name' => 'Doe',
+    ]
+];
+
 $last_names = array_column($records, 'last_name', 'id');
 print_r($last_names);
+
 ?>
 ]]>
     </programlisting>
@@ -202,6 +229,7 @@ $users = [
 ];
 
 print_r(array_column($users, 'username'));
+
 ?>
 ]]>
     </programlisting>
@@ -222,7 +250,7 @@ Array
    <example>
     <title>
      Obtém a coluna de nomes da propriedade privada "name" de um objeto
-     utilizando o método mágico <function>__get</function>.
+     utilizando os métodos mágicos <function>__isset</function> e <function>__get</function>
     </title>
     <programlisting role="php">
 <![CDATA[

diff --git a/reference/fpm/status.xml b/reference/fpm/status.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 2c4f02dcf9781000405646b9b21f9182aea76496 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: a4429100780d1d0d6ce204c11ad223f6526990ab Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
 
 <sect1 xml:id="fpm.status" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Página de status</title>
@@ -175,6 +175,12 @@
        <literal>request_slowlog_timeout</literal> configurado.
       </entry>
      </row>
+     <row>
+      <entry>memory peak</entry>
+      <entry>
+       O pico de uso de memória desde a inicialização do FPM.
+      </entry>
+     </row>
     </tbody>
    </tgroup>
   </table>

diff --git a/reference/mysqli/ini.xml b/reference/mysqli/ini.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: f26734be49cca400204fcf3243271c7ff138823d Maintainer: ae Status: ready --><!-- CREDITS: diegopires,fernandoc -->
+<!-- EN-Revision: 90787fda14dcb0976a9738423e6c6013c037d048 Maintainer: leonardolara Status: ready --><!-- CREDITS: diegopires,fernandoc,ae,leonardolara -->
 <section xml:id="mysqli.configuration" xmlns="http://docbook.org/ns/docbook">
  &reftitle.runtime;
  &extension.runtime;
@@ -106,7 +106,7 @@
   <varlistentry xml:id="ini.mysqli.allow-local-infile">
    <term>
     <parameter>mysqli.allow_local_infile</parameter>
-    <type>int</type>
+    <type>bool</type>
    </term>
    <listitem>
     <para>
@@ -132,7 +132,7 @@
   <varlistentry xml:id="ini.mysqli.allow-persistent">
    <term>
     <parameter>mysqli.allow_persistent</parameter>
-    <type>int</type>
+    <type>bool</type>
    </term>
    <listitem>
     <para>

diff --git a/reference/pcre/pattern.modifiers.xml b/reference/pcre/pattern.modifiers.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c43393d1b64a41be1b8c45f997062b0f645bc91e Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<!-- EN-Revision: b5aa3464c8817645633dc4364e1ac2d7b92c5b3f Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
 <article xml:id="reference.pcre.pattern.modifiers" xmlns="http://docbook.org/ns/docbook">
  <title>Modificadores de Expressão</title>
  <titleabbrev>Possíveis modificadores em expressões regulares</titleabbrev>
@@ -196,7 +196,7 @@
        </simpara>
        <simpara>
         Por exemplo, <code>preg_match('/\x{212A}/iu', "K")</code> corresponde ao símbolo de Kelvin <literal>K</literal> (U+212A).
-        Quando <emphasis>u</emphasis> é usado (<code>preg_match('/\x{212A}/iur', "K")</code>), não há correspondência.
+        Quando <emphasis>r</emphasis> é usado (<code>preg_match('/\x{212A}/iur', "K")</code>), não há correspondência.
        </simpara>
        <simpara>
         Disponível a partir do PHP 8.4.0.

diff --git a/reference/pdo_cubrid/reference.xml b/reference/pdo_cubrid/reference.xml
@@ -1,7 +1,7 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 1993c38d254743d8c0a2140ff6f797660997083d Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 3c1bec9d700807df36994cf368ba291214cd424d Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
 <reference xml:id="ref.pdo-cubrid" xmlns="http://docbook.org/ns/docbook"><?phpdoc extension-membership="pecl" ?>
- <title>Funções CUBRID (PDO_CUBRID)</title>
- <titleabbrev>CUBRID (PDO)</titleabbrev>
+ <title>Driver PDO do CUBRID (PDO_CUBRID)</title>
+ <titleabbrev>Driver PDO do CUBRID</titleabbrev>
  <partintro>
 
    <section xml:id="pdo-cubrid.intro">&reftitle.intro;

diff --git a/reference/pdo_dblib/reference.xml b/reference/pdo_dblib/reference.xml
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 6b5b64c2552eba77e78556b9ab62f6d64aacff8e Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 3c1bec9d700807df36994cf368ba291214cd424d Maintainer: leonardolara Status: ready -->
 
  <reference xml:id="ref.pdo-dblib" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <?phpdoc extension-membership="bundledexternal" ?>
-  <title>Funções do Microsoft SQL Server e Sybase (PDO_DBLIB)</title>
-  <titleabbrev>MS SQL Server (PDO)</titleabbrev>
+  <title>Driver PDO do Microsoft SQL Server e Sybase (PDO_DBLIB)</title>
+  <titleabbrev>Driver PDO do MS SQL Server</titleabbrev>
   <partintro>
 
    <section xml:id="ref.pdo-dblib.intro">

diff --git a/reference/pdo_firebird/reference.xml b/reference/pdo_firebird/reference.xml
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 6b5b64c2552eba77e78556b9ab62f6d64aacff8e Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 3c1bec9d700807df36994cf368ba291214cd424d Maintainer: leonardolara Status: ready -->
 
 <reference xml:id="ref.pdo-firebird" xmlns="http://docbook.org/ns/docbook">
  <?phpdoc extension-membership="bundledexternal" ?>
- <title>Funções de Firebird (PDO_FIREBIRD)</title>
- <titleabbrev>Firebird (PDO)</titleabbrev>
+ <title>Driver PDO do Firebird (PDO_FIREBIRD)</title>
+ <titleabbrev>Driver PDO do Firebird</titleabbrev>
  <partintro>
 
    <section xml:id="ref.pdo-firebird.intro">

diff --git a/reference/pdo_ibm/reference.xml b/reference/pdo_ibm/reference.xml
@@ -1,8 +1,8 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: cecccfc4d621a2dd0b6d9a6c76443551a768d12a Maintainer: leonardolara Status: ready -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 3c1bec9d700807df36994cf368ba291214cd424d Maintainer: leonardolara Status: ready -->
 <reference xml:id="ref.pdo-ibm" xmlns="http://docbook.org/ns/docbook">
  <?phpdoc extension-membership="pecl" ?>
-  <title>Funções da IBM (PDO_IBM)</title>
-  <titleabbrev>IBM (PDO)</titleabbrev>
+  <title>Driver PDO da IBM (PDO_IBM)</title>
+  <titleabbrev>Driver PDO da IBM</titleabbrev>
   <partintro>
 
    <section xml:id="pdo-ibm.intro">

diff --git a/reference/pdo_informix/reference.xml b/reference/pdo_informix/reference.xml
@@ -1,8 +1,8 @@
-<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 68c2c871505aadf983f16113c5b077b335ce8d76 Maintainer: leonardolara Status: ready -->
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 3c1bec9d700807df36994cf368ba291214cd424d Maintainer: leonardolara Status: ready -->
 <reference xml:id="ref.pdo-informix" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <?phpdoc extension-membership="pecl" ?>
- <title>Funções do Informix (PDO_INFORMIX)</title>
- <titleabbrev>Informix (PDO)</titleabbrev>
+ <title>Driver PDO do Informix (PDO_INFORMIX)</title>
+ <titleabbrev>Driver PDO do Informix</titleabbrev>
  <partintro>
 
   <section xml:id="pdo-informix.intro">

diff --git a/reference/pdo_mysql/reference.xml b/reference/pdo_mysql/reference.xml
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 6b5b64c2552eba77e78556b9ab62f6d64aacff8e Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe,leonardolara -->
+<!-- EN-Revision: 3c1bec9d700807df36994cf368ba291214cd424d Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe,leonardolara -->
 
 <reference xml:id="ref.pdo-mysql" xmlns="http://docbook.org/ns/docbook">
  <?phpdoc extension-membership="bundledexternal" ?>
- <title>Funções do MySQL (PDO_MYSQL)</title>
- <titleabbrev>MySQL (PDO)</titleabbrev>
+ <title>Driver PDO do MySQL (PDO_MYSQL)</title>
+ <titleabbrev>Driver PDO do MySQL</titleabbrev>
  <partintro>
 
    <section xml:id="ref.pdo-mysql.intro">

diff --git a/reference/pdo_oci/reference.xml b/reference/pdo_oci/reference.xml
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 86177fa035acc7fdb972855bdd6c0b19edd505cd Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 3c1bec9d700807df36994cf368ba291214cd424d Maintainer: leonardolara Status: ready -->
 
 <reference xml:id="ref.pdo-oci" xmlns="http://docbook.org/ns/docbook">
  <?phpdoc extension-membership="pecl" ?>
- <title>Funções do Oracle (PDO_OCI)</title>
- <titleabbrev>Oracle (PDO)</titleabbrev>
+ <title>Driver PDO do Oracle (PDO_OCI)</title>
+ <titleabbrev>Driver PDO do Oracle</titleabbrev>
  <partintro>
 
   &reference.pdo-oci.configure;