sync with en rev

php · Dec 7, 2024 · 3ad35c9 · 3ad35c9
1 parent 8dbaf84
commit 3ad35c9
Show file tree

Hide file tree

Showing 7 changed files with 96 additions and 19 deletions.
diff --git a/features/commandline.xml b/features/commandline.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: eee245cdbd89dc2fd908285f588e3b9e055924e5 Maintainer: ae Status: ready --><!-- CREDITS: ThamaraHessel,pauloelr,royopa,ae,geekcom,leonardolara -->
+<!-- EN-Revision: 4b4292baf79bb650763e8230dbb254ee59d5ce80 Maintainer: ae 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>
@@ -1479,11 +1479,13 @@ php > $foo[TAB]ThisIsAReallyLongVariableName
    </programlisting>
   </example>
 
-  <para>
+  <simpara>
    O shell interativo armazena seu histórico que pode ser acessado usando as
    teclas para cima e para baixo. O histórico é salvo no arquivo
    <filename>~/.php_history</filename>.
-  </para>
+   A partir do PHP 8.4.0, o caminho para o arquivo de histórico pode ser definido usando a
+   variável de ambiente <envar>PHP_HISTFILE</envar>.
+  </simpara>
 
   <para>
    O &cli.sapi; fornece as configurações do

diff --git a/language/predefined/closure.xml b/language/predefined/closure.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: ae Status: ready --><!-- CREDITS: fabioluciano,lhsazevedo,ae -->
+<!-- EN-Revision: da5ebdf7e0b710ac4f20b53f7c09cf9fa1346d3e Maintainer: ae Status: ready --><!-- CREDITS: fabioluciano,lhsazevedo,ae,leonardolara -->
 <reference xml:id="class.closure" 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 Closure</title>
@@ -53,6 +53,28 @@
 
   </section>
 
+  <section role="changelog">
+   &reftitle.changelog;
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        O resultado de <methodname>Closure::__debugInfo</methodname> agora inclui o
+        nome, a linha e o arquivo do closure.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </section>
  </partintro>
 
  &language.predefined.closure.construct;

diff --git a/language/predefined/weakreference.xml b/language/predefined/weakreference.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: cd391e65a613a729f9bbded2b1249e2d7143400c Maintainer: ae Status: ready --><!-- CREDITS: geekcom,ae -->
+<!-- EN-Revision: 7caf0c13762e7db3e7002b1286f23b65d940e2d0 Maintainer: ae Status: ready --><!-- CREDITS: geekcom,ae,leonardolara -->
 <reference xml:id="class.weakreference" 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 WeakReference</title>
@@ -80,6 +80,29 @@ NULL
    </para>
   </section>
 
+  <section role="changelog">
+   &reftitle.changelog;
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        O resultado de <methodname>WeakReference::__debugInfo</methodname> agora inclui
+        o objeto referenciado ou <literal>NULL</literal> se a referência não for mais
+        válida.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </section>
  </partintro>
 
  &language.predefined.weakreference.construct;

diff --git a/reference/apcu/ini.xml b/reference/apcu/ini.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ba990c472c6d032479ea12f062abde0b1d7a80a2 Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 83fd65e9a07d7c703bf4367936e4d19ade030662 Maintainer: leonardolara Status: ready -->
 <section xml:id="apcu.configuration" xmlns="http://docbook.org/ns/docbook">
  &reftitle.runtime;
  &extension.runtime;
@@ -229,13 +229,11 @@
     <listitem>
      <para>
       O número de segundos que uma entrada de cache pode
-      permanecer na lista de coleta de lixo. Este valor
-      fornece uma alternativa à prova de falhas no caso um processo do
-      servidor seja terminado ao executar um arquivo com origem em cache;
-      se este arquivo for modificado, a memória
-      alocada para a versão antiga não será
-      recuperada aque que este TTL seja alcançado. Defina para zero para
-      desabilitar este recurso.
+      permanecer na lista de coleta de lixo após ser removida ou inicializada.
+      Uma entrada é elegível a remoção se sua contagem de referência for zero,
+      ou se exceder este limite de tempo.
+      Se definido para <literal>0</literal>, a limpeza baseada em tempo é desativada,
+      e as entradas só serão removidas quando suas contagens de referência caírem para zero.
      </para>
     </listitem>
    </varlistentry>

diff --git a/reference/math/functions/round.xml b/reference/math/functions/round.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 6406cc6c50f8f66f7d55f550dc1ec2759e2eca0f Maintainer: ae Status: ready --><!-- CREDITS: marquesdanielb,ae -->
+<!-- EN-Revision: f721489eaeb79ff096971fe5a5b101c2ebab8eeb Maintainer: ae Status: ready --><!-- CREDITS: marquesdanielb,ae,leonardolara -->
 <refentry xml:id="function.round" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>round</refname>
@@ -125,6 +125,15 @@
   </para>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <simpara>
+   A função lança uma exceção <exceptionname>ValueError</exceptionname> se <parameter>mode</parameter> for
+   inválido.
+   Antes do PHP 8.4.0, um modo inválido seria considerado, silenciosamente, como o padrão <constant>PHP_ROUND_HALF_UP</constant>.
+  </simpara>
+ </refsect1>
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <informaltable>
@@ -136,6 +145,13 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       Agora lança uma exceção <exceptionname>ValueError</exceptionname> se
+       <parameter>mode</parameter> for inválido.
+      </entry>
+     </row>
      <row>
       <entry>8.0.0</entry>
       <entry>

diff --git a/reference/opcache/ini.xml b/reference/opcache/ini.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 0b7ba7f50bfefd540fefd257425a1a60718c6b75 Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin, leonardolara -->
+<!-- EN-Revision: 33437fb390b792266f4bdae7a0797808a6d7b9d4 Maintainer: leonardolara Status: ready --><!-- CREDITS: marcosmarcolin, leonardolara -->
 <sect1 xml:id="opcache.configuration" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.runtime;
  &extension.runtime;
@@ -962,6 +962,8 @@
       para servidores que inicializam como root antes de alternar para um usuário de sistema sem privilégios.
       O pré-carregamento como root não é permitido por padrão por motivos de segurança,
       a menos que esta diretiva seja explicitamente definida como <literal>root</literal>.
+      A partir do PHP 8.3.0, esta diretiva não precisa ser definida para permitir pré-carregamento quando
+      executado como root ao usar o &cli.sapi; ou o <link linkend="book.phpdbg">SAPI phpdbg</link>.
      </para>
     </listitem>
    </varlistentry>

diff --git a/reference/var/functions/unserialize.xml b/reference/var/functions/unserialize.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 3dbbc167de33c0214f454b1d0399a32c88127c10 Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 792c392854b954fc5626c1ac194d516312e51f43 Maintainer: leonardolara Status: ready -->
 <refentry xml:id="function.unserialize" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>unserialize</refname>
@@ -141,9 +141,15 @@
 
  <refsect1 role="errors">
   &reftitle.errors;
-  <para>
-   Objetos podem disparar exceções da classe <classname>Throwable</classname> em seus manipuladores de desserialização.
-  </para>
+  <simpara>
+   Objetos podem lançar exceções da classe <classname>Throwable</classname> em seus manipuladores de desserialização.
+  </simpara>
+  <simpara>
+   A partir do PHP 8.4.0, se o elemento <literal>allowed_classes</literal> do parâmetro
+   <parameter>options</parameter> não for um <type>array</type> de nomes de classes,
+   <function>unserialize</function> lança exceções <exceptionname>TypeError</exceptionname>s
+   e <exceptionname>ValueError</exceptionname>s.
+  </simpara>
  </refsect1>
 
  <refsect1 role="changelog">
@@ -152,6 +158,14 @@
    <informaltable>
     <tgroup cols="2">
      <thead>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        Agora lança exceções <exceptionname>TypeError</exceptionname>s e
+        <exceptionname>ValueError</exceptionname>s se o elemento <literal>allowed_classes</literal>
+        de <parameter>options</parameter> não for um <type>array</type> de nomes de classes.
+       </entry>
+      </row>
       <row>
        <entry>&Version;</entry>
        <entry>&Description;</entry>