sync with en rev

php · Nov 16, 2024 · e04073e · e04073e
1 parent e9bb494
commit e04073e
Show file tree

Hide file tree

Showing 11 changed files with 150 additions and 93 deletions.
diff --git a/language-snippets.ent b/language-snippets.ent
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: d0e23f48165c79327727e3a51b8277104975e3ad Maintainer: adiel Status: ready --><!-- CREDITS: adiel, ae, atomotavio, fabioluciano, felipe, klaussilveira, rafaelbernard, leonardolara, fernandowobeto -->
+<!-- EN-Revision: d0e23f48165c79327727e3a51b8277104975e3ad Maintainer: leonardolara Status: ready --><!-- CREDITS: adiel, ae, atomotavio, fabioluciano, felipe, klaussilveira, rafaelbernard, leonardolara, fernandowobeto -->
 
 <!ENTITY installation.enabled.disable 'Esta extensão está habilitada por padrão. Ela pode ser desabilitada usando a seguinte opção em tempo de compilação: '>
 
@@ -4488,17 +4488,39 @@ xmlns="http://docbook.org/ns/docbook"><simpara>Esta função foi
 </varlistentry>'>
 
 <!ENTITY xml.handler.description '<para xmlns="http://docbook.org/ns/docbook">
- Se &null; ou uma string vazia for passada, o manipulador será redefinido para seu estado padrão.
+ Se &null; for passado, o manipulador é redefinido para seu estado padrão.
+ <warning>
+  <simpara>
+    Uma string vazia também redefine o manipulador,
+    entretanto isto foi descontinuado a partir do PHP 8.4.0.
+  </simpara>
+ </warning>
 </para>
 <para xmlns="http://docbook.org/ns/docbook">
  Se <parameter>handler</parameter> for um <type>callable</type>,
  o callable será definido como o manipulador.
 </para>
 <para xmlns="http://docbook.org/ns/docbook">
  Se <parameter>handler</parameter> for uma <type>string</type>,
- ela pode ser o nome de um método de um objet definido com
+ ela pode ser o nome de um método de um objeto definido com
  <function>xml_set_object</function>.
-</para>'>
+ <warning>
+  <simpara>
+   Isto foi descontinuado a partir do PHP 8.4.0.
+  </simpara>
+ </warning>
+</para>
+<warning xmlns="http://docbook.org/ns/docbook">
+ <simpara>
+  A partir do PHP 8.4.0, a função de retorno é verificada quanto à validade ao configurar o manipulador,
+  e não quando é chamada.
+  Isto significa que <function>xml_set_object</function> precisa ser chamada antes de
+  configurar uma string de método como a função de retorno.
+  Entretando, como este comportamento também foi descontinuado a partir do PHP 8.4.0,
+  usar um <type>callable</type> adequado para o método é recomendado.
+ </simpara>
+</warning>
+'>
 
 <!ENTITY xml.handler.parser.param '<varlistentry xmlns="http://docbook.org/ns/docbook">
  <term><parameter>parser</parameter></term>
@@ -4509,6 +4531,22 @@ xmlns="http://docbook.org/ns/docbook"><simpara>Esta função foi
  </listitem>
 </varlistentry>'>
 
+<!ENTITY xml.changelog.handler-param '<row xmlns="http://docbook.org/ns/docbook">
+ <entry>8.4.0</entry>
+ <entry>
+  Passar uma <type>string</type> não-<type>callable</type> no parâmetro
+  <parameter>handler</parameter> foi descontinuado,
+  use um chamável apropriado para métodos, ou &null; para redefinir o manipulador.
+ </entry>
+</row>
+<row xmlns="http://docbook.org/ns/docbook">
+ <entry>8.4.0</entry>
+ <entry>
+  A validade do manipulador <parameter>handler</parameter> como um tipo <type>callable</type>
+  agora é verificada ao configurar o manipulador ao invés de verificar na chamada.
+ </entry>
+</row>'>
+
 <!ENTITY xml.changelog.parser-param '<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.0.0</entry>
  <entry>

diff --git a/reference/apache/functions/apache-request-headers.xml b/reference/apache/functions/apache-request-headers.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: f3b9d85f71934d6814a493fabb367e10731e0394 Maintainer: ae Status: ready --><!-- CREDITS: adiel,ae,fabioluciano -->
+<!-- EN-Revision: 68e52ef14de33f6752a8fdda1ae83c861c5babdb Maintainer: ae Status: ready --><!-- CREDITS: adiel,ae,fabioluciano,leonardolara -->
 <!-- splitted from ./en/functions/apache.xml, last change in rev 1.2 -->
 <refentry xml:id="function.apache-request-headers" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -15,7 +15,7 @@
   </methodsynopsis>
   <para>
    Obtém todos os cabeçalhos HTTP da requisição atual. Funciona na
-   CLI e nos servidores web Apache, FastCGI e FPM.
+   SAPI CLI e nos servidores web Apache, FastCGI e FPM.
   </para>
  </refsect1>
 
@@ -27,8 +27,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Um array associativo de todos os cabeçalho HTTP da requisição atual, ou
-   &false; em caso de falha.
+   Um array associativo de todos os cabeçalhos HTTP da requisição atual.
   </para>
  </refsect1>
 

diff --git a/reference/apache/functions/apache-response-headers.xml b/reference/apache/functions/apache-response-headers.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: f3b9d85f71934d6814a493fabb367e10731e0394 Maintainer: ae Status: ready --><!-- CREDITS: adiel,ae,fabioluciano -->
+<!-- EN-Revision: 68e52ef14de33f6752a8fdda1ae83c861c5babdb Maintainer: ae Status: ready --><!-- CREDITS: adiel,ae,fabioluciano -->
 <!-- splitted from ./en/functions/apache.xml, last change in rev 1.2 -->
 <refentry xml:id="function.apache-response-headers" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -10,7 +10,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type class="union"><type>array</type><type>false</type></type><methodname>apache_response_headers</methodname>
+   <type>array</type><methodname>apache_response_headers</methodname>
    <void/>
   </methodsynopsis>
   <para>
@@ -27,7 +27,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Um array de todos os cabeçalhos de resposta do Apache em caso de sucesso, ou &return.falseforfailure;.
+   Um array de todos os cabeçalhos de resposta do Apache em caso de sucesso.
   </para>
  </refsect1>
 

diff --git a/reference/apache/functions/getallheaders.xml b/reference/apache/functions/getallheaders.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: f3b9d85f71934d6814a493fabb367e10731e0394 Maintainer: ae Status: ready --><!-- CREDITS: ae,fabioluciano,adiel -->
+<!-- EN-Revision: 68e52ef14de33f6752a8fdda1ae83c861c5babdb Maintainer: ae Status: ready --><!-- CREDITS: ae,fabioluciano,adiel -->
 <!-- splitted from ./en/functions/apache.xml, last change in rev 1.2 -->
 <refentry xml:id="function.getallheaders" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -31,8 +31,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Um array associativo de todos cabeçalhos HTTP da requisição atual, ou
-   &false; em caso de falha.
+   Um array associativo de todos cabeçalhos HTTP da requisição atual.
   </para>
  </refsect1>
 

diff --git a/reference/errorfunc/functions/trigger-error.xml b/reference/errorfunc/functions/trigger-error.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 210d382b5b139444fe2e16a5a3211076a65ff2ba Maintainer: leonardolara Status: ready --><!-- CREDITS: royopa,fernandoc,leonardolara -->
+<!-- EN-Revision: 72b70d7c3c3b2b87423641906da2db407c32c3c3 Maintainer: leonardolara Status: ready --><!-- CREDITS: royopa,fernandoc,leonardolara -->
 <refentry xml:id="function.trigger-error" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>trigger_error</refname>
@@ -46,6 +46,14 @@
        O tipo de erro designado para este erro. Funciona apenas com a família de constantes
        <constant>E_USER_<replaceable>*</replaceable></constant>, e o padrão é <constant>E_USER_NOTICE</constant>.
       </para>
+      <warning>
+       <simpara>
+        Passar <constant>E_USER_ERROR</constant> como o
+        <parameter>error_level</parameter> agora foi descontinuado.
+        Alternativamente, uma <exceptionname>Exception</exceptionname> pode ser lançada ou
+        <function>exit</function> pode ser chamada.
+       </simpara>
+      </warning>
      </listitem>
     </varlistentry>
    </variablelist>
@@ -80,6 +88,22 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       Passar <constant>E_USER_ERROR</constant> como
+       <parameter>error_level</parameter> agora foi descontinuado.
+       Alternativamente, uma <exceptionname>Exception</exceptionname> pode ser lançada
+       ou <function>exit</function> pode ser chamada.
+      </entry>
+     </row>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       A função agora tem um tipo de retorno <type>true</type>
+       ao invés de <type>bool</type>.
+      </entry>
+     </row>
      <row>
       <entry>8.0.0</entry>
       <entry>
@@ -92,7 +116,6 @@
   </informaltable>
  </refsect1>
 
-
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -104,9 +127,11 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-if (assert($divisor == 0)) {
-    trigger_error("Não é possível dividir por zero", E_USER_ERROR);
+$password = $_POST['password'] ?? '';
+if ($password === '') {
+    trigger_error("Usar uma senha vazia não é seguro", E_USER_WARNING);
 }
+$hash = password_hash($password, PASSWORD_DEFAULT);
 ?>
 ]]>
     </programlisting>
@@ -133,6 +158,7 @@ if (assert($divisor == 0)) {
     <member><function>set_error_handler</function></member>
     <member><function>restore_error_handler</function></member>
     <member>As <link linkend="errorfunc.constants">constantes de nível de erro</link></member>
+    <member>O atributo <classname>Deprecated</classname></member>
    </simplelist>
   </para>
  </refsect1>

diff --git a/reference/posix/constants.xml b/reference/posix/constants.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 61374bbe228e8e9c55a24aba59a1e2bb2a871148 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: ff5efae44740c783b58676ccc68cfd6b198e1e91 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
 <appendix xml:id="posix.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
  &extension.constants;
@@ -561,6 +561,30 @@
      </simpara>
     </listitem>
    </varlistentry>
+   <varlistentry xml:id="constant.posix-sc-child-max">
+    <term>
+     <constant>POSIX_SC_CHILD_MAX</constant>
+     (<type>int</type>)
+    </term>
+    <listitem>
+     <simpara>
+      O número máximo de processos simultâneos por usuário.
+      Disponível a partir do PHP 8.4.0.
+     </simpara>
+    </listitem>
+   </varlistentry>
+   <varlistentry xml:id="constant.posix-sc-clk-tk">
+    <term>
+     <constant>POSIX_SC_CLK_TK</constant>
+     (<type>int</type>)
+    </term>
+    <listitem>
+     <simpara>
+      O número de tiques do relógio por segundo.
+      Disponível a partir do PHP 8.4.0.
+     </simpara>
+    </listitem>
+   </varlistentry>
   </variablelist>
  </section>
 </appendix>

diff --git a/reference/readline/book.xml b/reference/readline/book.xml
@@ -1,17 +1,17 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: b9582e11e41e0d06e1bd4a499ce6db383692759b Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandoc,felipe,fernandowobeto,leonardolara -->
+<!-- EN-Revision: 51779f7c42f39934403805a42b83cef7126a5fc1 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandoc,felipe,fernandowobeto,leonardolara -->
 
 <book xml:id="book.readline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <?phpdoc extension-membership="bundledexternal" ?>
- <title>Readline</title>
+ <title>Readline GNU</title>
  <titleabbrev>Readline</titleabbrev>
 
  <!-- {{{ preface -->
  <preface xml:id="intro.readline">
   &reftitle.intro;
   <para>
    As funções readline implementam uma interface para
-   a biblioteca libedit. Estas são funções que fornecem
+   a biblioteca Readline GNU. Estas são funções que fornecem
    linhas de comando editáveis. Um exeplo é a maneira que o Bash permite
    usar as teclas de setas para inserir caracteres ou navegar pelo
    histórico dos comandos. Por causa da naturesa interativa desta

diff --git a/reference/readline/configure.xml b/reference/readline/configure.xml
@@ -1,43 +1,17 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: b9582e11e41e0d06e1bd4a499ce6db383692759b Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandoc,fernandowobeto,leonardolara -->
+<!-- EN-Revision: 51779f7c42f39934403805a42b83cef7126a5fc1 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandoc,fernandowobeto,leonardolara -->
 <section xml:id="readline.installation" xmlns="http://docbook.org/ns/docbook">
  &reftitle.install;
  <para>
   Para usar estas funções, as versões CGI ou CLI do PHP devem ser compiladas
-  com suporte à readline. É necessário configurar o PHP com
-  <option role="configure">--with-readline</option>.
+  com suporte a readline. É necessário configurar o PHP com a opção
+  <option role="configure">--with-readline[=DIR]</option>.
+  Se a intenção for usar a biblioteca substituta libedit, o PHP deve ser configurado com
+  <option role="configure">--with-libedit[=DIR]</option>.
  </para>
  <para>
   No Windows, esta extensão está disponível por padrão a partir do PHP 7.1.0.
  </para>
- <simplesect role="changelog">
-  &reftitle.changelog;
-  <para>
-   <informaltable>
-    <tgroup cols="2">
-     <thead>
-      <row>
-       <entry>&Version;</entry>
-       <entry>&Description;</entry>
-      </row>
-     </thead>
-     <tbody>
-      <row>
-       <entry>8.4.0</entry>
-       <entry>
-        A opção de configuração <option role="configure">--with-libedit</option>
-        foi removida em favor da opção
-        <option role="configure">--with-readline</option> que não mais
-        aceita um argumento DIR, em favor do pkg-config, and agora vincula
-        à biblioteca libedit, uma substituta não-GPL para a biblioteca GNU
-        Readline.
-       </entry>
-      </row>
-     </tbody>
-    </tgroup>
-   </informaltable>
-  </para>
- </simplesect>
 </section>
 
 <!-- Keep this comment at the end of the file

diff --git a/reference/readline/constants.xml b/reference/readline/constants.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: f8e440fe2967dfdc9018e3cff560d62d2f2ec678 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: felipe,fernandowobeto,leonardolara -->
+<!-- EN-Revision: 51779f7c42f39934403805a42b83cef7126a5fc1 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: felipe,fernandowobeto,leonardolara -->
 <appendix xml:id="readline.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.constants;
  &extension.constants;
@@ -14,38 +14,9 @@
      A biblioteca usada para suporte ao Readline; atualmente pode ser
      <literal>readline</literal> ou <literal>libedit</literal>.
     </simpara>
-    <simpara>
-     Removida a partir do PHP 8.4.0.
-    </simpara>
    </listitem>
   </varlistentry>
  </variablelist>
-
- <formalpara>
-  &reftitle.changelog;
-  <para>
-   <informaltable>
-    <tgroup cols="2">
-     <thead>
-      <row>
-       <entry>&Version;</entry>
-       <entry>&Description;</entry>
-      </row>
-     </thead>
-     <tbody>
-      <row>
-       <entry>8.4.0</entry>
-       <entry>
-        A constante <constant>READLINE_LIB</constant> foi removida. Continha a biblioteca
-        usada para suporte a readline, com valor <literal>readline</literal>
-        ou <literal>libedit</literal>.
-       </entry>
-      </row>
-     </tbody>
-    </tgroup>
-   </informaltable>
-  </para>
- </formalpara>
 </appendix>
 <!-- Keep this comment at the end of the file
 Local variables:

diff --git a/reference/readline/setup.xml b/reference/readline/setup.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: b9582e11e41e0d06e1bd4a499ce6db383692759b Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandoc,fernandowobeto,leonardolara -->
+<!-- EN-Revision: 51779f7c42f39934403805a42b83cef7126a5fc1 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandoc,fernandowobeto,leonardolara -->
 
 <chapter xml:id="readline.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.setup;
@@ -8,8 +8,15 @@
  <section xml:id="readline.requirements">
   &reftitle.required;
   <para>
-   Para usar as funções readline, a biblioteca libedit precisa estar instalada. a
-   biblioteca libedit está sob a licença BSD e está disponível em
+   Para usar as funções readline, é necessário instalar o libreadlinem que pode ser
+   encontrado na página inicial do projeto Readline GNU, em
+   <link xlink:href="&url.readline;">&url.readline;</link>.
+   É mantido por Chet Ramey, que também é autor do Bash.
+  </para>
+  <para>
+   Essas funções também podem ser usadas com a biblioteca libedit, uma substituição
+   não-GPL para a biblioteca readline. A biblioteca libedit é licenciada por BSD
+   e está disponível para download em
    <link xlink:href="&url.libedit;">&url.libedit;</link>.
   </para>
  </section>