sync with en rev

php · Nov 22, 2024 · 790f871 · 790f871
1 parent 0e8f33b
commit 790f871
Show file tree

Hide file tree

Showing 25 changed files with 439 additions and 128 deletions.
diff --git a/appendices/migration80/incompatible.xml b/appendices/migration80/incompatible.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 61374bbe228e8e9c55a24aba59a1e2bb2a871148 Maintainer: ae Status: ready --><!-- CREDITS: geekcom,adiel,lhsazevedo,atomotavio,ae,leonardolara -->
+<!-- EN-Revision: b94d63fc0884d83ba43433ab33cc4810d955bf6d Maintainer: ae Status: ready --><!-- CREDITS: geekcom,adiel,lhsazevedo,atomotavio,ae,leonardolara -->
 
 <sect1 xml:id="migration80.incompatible" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Alterações incompatíveis com versões anteriores</title>
@@ -1645,7 +1645,7 @@ echo file_get_contents('http://example.org', false, $ctx);
   <title>XMLReader</title>
 
   <para>
-   <methodname>XMLReader::open</methodname> e <methodname>XMLReader::xml</methodname> agora são
+   <methodname>XMLReader::open</methodname> e <methodname>XMLReader::XML</methodname> agora são
    métodos estáticos. Eles ainda podem ser chamados como métodos de instância, mas classes herdadas precisam declará-los
    como estáticos se elas sobrescrevem esses métodos.
   </para>

diff --git a/reference/dom/constants.xml b/reference/dom/constants.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: f44eff3695dbe664b4acf5d32e1643fe6448b51c Maintainer: leonardolara Status: ready --><!-- CREDITS: marabesi,leonardolara -->
+<!-- EN-Revision: 38d0723a6e865c163527b252afbca7fc91ac473d Maintainer: leonardolara Status: ready --><!-- CREDITS: marabesi,leonardolara -->
 <chapter xml:id="dom.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
  &extension.constants;
@@ -259,7 +259,10 @@
      </entry>
      <entry>0</entry>
      <entry>
-      Código não pertencente á especificação DOM. Significativa apenas para erros do PHP
+      Código não pertencente à especificação DOM. Significativa apenas para erros do PHP.
+      Descontinuada a partir do PHP 8.4.0 por não ser mais usada.
+      Antes do PHP 8.4.0, era inconsistentemente usada para indicar
+      situações de falta de memória.
      </entry>
     </row>
     <row xml:id="constant.dom-index-size-err">

diff --git a/reference/dom/domdocument.xml b/reference/dom/domdocument.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 0217f85ed26dc9511fb6b44e87d82f4b77adafa1 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
+<!-- EN-Revision: 38d0723a6e865c163527b252afbca7fc91ac473d Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
 <reference xml:id="class.domdocument" 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 DOMDocument</title>
  <titleabbrev>DOMDocument</titleabbrev>
@@ -186,8 +186,8 @@
      <term><varname>actualEncoding</varname></term>
      <listitem>
       <para>
-       <emphasis>Descontinuado</emphasis>.Codificação real do documento,
-       é uma leitura apenas equivalente a
+       <emphasis>Descontinuado a partir do PHP 8.4.0</emphasis>.
+       Codificação real do documento, é uma equivalente somente-leitura de
        <varname linkend="domdocument.props.encoding">encoding</varname>.
       </para>
      </listitem>
@@ -202,7 +202,8 @@
      <term><varname>config</varname></term>
      <listitem>
       <para>
-       <emphasis>Descontinuado</emphasis>. Configuração usando quando
+       <emphasis>Descontinuado a partir do PHP 8.4.0</emphasis>.
+       Configuração usada quando
        <function>DOMDocument::normalizeDocument</function> é
        invocada.
       </para>
@@ -321,8 +322,8 @@
      <term><varname>substituteEntities</varname></term>
      <listitem>
       <para>
-       <emphasis>Proprietário</emphasis>. Se deve ou não substituir
-       entidades. Este atributo não faz parte da
+       <emphasis>Proprietário</emphasis>. Informa de entidades devem ou não
+       ser subtituídas. Este atributo não faz parte da
        especificação DOM e é específico para o libxml. Padrão é &false;.
       </para>
       <caution>
@@ -399,11 +400,18 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        <varname>actualEncoding</varname> e
+        <varname>config</varname> agora estão formalmente descontinuados.
+       </entry>
+      </row>
       <row>
        <entry>8.0.0</entry>
        <entry>
-        <classname>DOMDocument</classname> implements
-        <interfacename>DOMParentNode</interfacename> now.
+        <classname>DOMDocument</classname> agora implementa
+        <interfacename>DOMParentNode</interfacename>.
        </entry>
       </row>
       <row>

diff --git a/reference/dom/domentity.xml b/reference/dom/domentity.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 38d0723a6e865c163527b252afbca7fc91ac473d Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
 <reference xml:id="class.domentity" 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 DOMEntity</title>
  <titleabbrev>DOMEntity</titleabbrev>
@@ -119,37 +119,58 @@
      <term><varname>actualEncoding</varname></term>
      <listitem>
       <para>
-       Um atributo que especifica a codificação usada para esta entidade no
-       momento da análise, quando é uma entidade analisada externa. Isso é
-       &null; se for uma entidade do subconjunto interno ou se não for
-       conhecido.
+       <emphasis>Descontinuada a partir do PHP 8.4.0</emphasis>.
+       Sempre foi igual a &null;.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry xml:id="domentity.props.encoding">
      <term><varname>encoding</varname></term>
      <listitem>
       <para>
-       Um atributo que especifica, como parte da declaração de texto, a
-       codificação desta entidade, quando é uma entidade analisada externa. Isso
-       é &null; caso contrário.
+       <emphasis>Descontinuada a partir do PHP 8.4.0</emphasis>.
+       Sempre foi igual a &null;.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry xml:id="domentity.props.version">
      <term><varname>version</varname></term>
      <listitem>
       <para>
-       Um atributo que especifica, como parte da declaração de texto, o
-       número da versão desta entidade, quando é uma entidade analisada
-       externa. Isso é &null; caso contrário.
+       <emphasis>Descontinuada a partir do PHP 8.4.0</emphasis>.
+       Sempre foi igual a &null;.
       </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </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>
+       <varname>actualEncoding</varname>,
+       <varname>encoding</varname> e
+       <varname>version</varname> agora estão formalmente descontinuadas porque sempre
+       foram iguais a &null;.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </section>
+
 <!-- {{{ See also -->
 <!--
   <section role="seealso">

diff --git a/reference/dom/domnode.xml b/reference/dom/domnode.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: f1516b33abc82b59d0b8a52b973d64f4857939cc Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
+<!-- EN-Revision: 4b6c8a5a9469b5c02585618d5a6e0774ca37530f Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
 <reference xml:id="class.domnode" 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 DOMNode</title>
  <titleabbrev>DOMNode</titleabbrev>
@@ -404,6 +404,33 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        O método <methodname>DOMNode::compareDocumentPosition</methodname> foi
+        adicionado.
+       </entry>
+      </row>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        As constantes <constant>DOMNode::DOCUMENT_POSITION_DISCONNECTED</constant>,
+        <constant>DOMNode::DOCUMENT_POSITION_PRECEDING</constant>,
+        <constant>DOMNode::DOCUMENT_POSITION_FOLLOWING</constant>,
+        <constant>DOMNode::DOCUMENT_POSITION_CONTAINS</constant>,
+        <constant>DOMNode::DOCUMENT_POSITION_CONTAINED_BY</constant>
+        e
+        <constant>DOMNode::DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC</constant>
+        foram adicionadas.
+       </entry>
+      </row>
+      <row>
+       <entry>8.3.0</entry>
+       <entry>
+        Os métodos <methodname>DOMNode::contains</methodname> e
+        <methodname>DOMNode::isEqualNode</methodname> foram adicionados.
+       </entry>
+      </row>
       <row>
        <entry>8.3.0</entry>
        <entry>

diff --git a/reference/dom/domxpath/registerphpfunctions.xml b/reference/dom/domxpath/registerphpfunctions.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4f5e2b22575131fa5e9c3004b1c874e1acb06573 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 2bd9a67c8c6c5961189f868364837a5c3ba7e063 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
 <refentry xml:id="domxpath.registerphpfunctions" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>DOMXPath::registerPhpFunctions</refname>
@@ -29,8 +29,11 @@
        Use este parâmetro para permitir apenas que certas funções sejam chamadas do XPath.
       </para>
       <para>
-       Este parâmetro pode ser uma <type>string</type> (um nome de função) ou
-       um <type>array</type> de nomes de função.
+       Este parâmetro pode ser um dos seguintes:
+       uma <type>string</type> (um nome de função),
+       um <type>array</type> indexado de nomes de funções
+       ou um <type>array</type> associativo com chaves nos nomes de funções
+       e valores associados sendo do tipo <type>callable</type>.
       </para>
      </listitem>
     </varlistentry>
@@ -45,6 +48,30 @@
   </para>
  </refsect1>
 
+ <refsect1 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>
+       Agora é possível usar <type>callable</type>s para funções de retorno
+       ao usar <parameter>restrict</parameter> com entradas de
+       <type>array</type>.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -144,6 +171,43 @@ foreach ($books as $book) {
     echo $book->getElementsByTagName("title")->item(0)->nodeValue . "\n";
 }
 
+?>
+]]>
+    </programlisting>
+    &example.outputs.similar;
+    <screen>
+<![CDATA[
+Books with multiple authors:
+PHP Basics
+]]>
+    </screen>
+   </example>
+  </para>
+  <para>
+   <example>
+    <title><methodname>DOMXPath::registerPHPFunctions</methodname> com um <type>callable</type></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$doc = new DOMDocument;
+$doc->load('book.xml');
+
+$xpath = new DOMXPath($doc);
+
+// Registra o namespace php: (necessário)
+$xpath->registerNamespace("php", "http://php.net/xpath");
+
+// Registra funções PHP (somente has_multiple)
+$xpath->registerPHPFunctions(["has_multiple" => fn ($nodes) => count($nodes) > 1]);
+
+// Filtra livros com múltiplos autores
+$books = $xpath->query('//book[php:function("has_multiple", author)]');
+
+echo "Livros com múltiplos autores:\n";
+foreach ($books as $book) {
+    echo $book->getElementsByTagName("title")->item(0)->nodeValue . "\n";
+}
+
 ?>
 ]]>
     </programlisting>
@@ -165,6 +229,7 @@ PHP Basics
     <member><methodname>DOMXPath::registerNamespace</methodname></member>
     <member><methodname>DOMXPath::query</methodname></member>
     <member><methodname>DOMXPath::evaluate</methodname></member>
+    <member><methodname>XSLTProcessor::registerPHPFunctions</methodname></member>
    </simplelist>
   </para>
  </refsect1>

diff --git a/reference/imap/book.xml b/reference/imap/book.xml
@@ -1,16 +1,20 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 34892f82742329af7e7b4b22be6ad21418fd9768 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
-
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 86177fa035acc7fdb972855bdd6c0b19edd505cd Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
+<!-- State: deprecated -->
 <book xml:id="book.imap" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- <?phpdoc extension-membership="bundledexternal" ?>
+ <?phpdoc extension-membership="pecl" ?>
  <title>IMAP, POP3 e NNTP</title>
  <titleabbrev>IMAP</titleabbrev>
 
  <!-- {{{ preface -->
  <preface xml:id="intro.imap">
   &reftitle.intro;
+  <warning>
+   <simpara>
+    Esta extesão foi <emphasis>DESCONTINUADA</emphasis> e <emphasis>DESAGREGADA</emphasis> a partir do PHP 8.4.0.
+   </simpara>
+  </warning>
   <para>
-   Essas funções permitem que você opere com o protocolo <acronym>IMAP</acronym>,
+   Essas funções permitem operações com o protocolo <acronym>IMAP</acronym>,
    bem como com os métodos de acesso <acronym>NNTP</acronym>, <acronym>POP3</acronym>
    e caixa de correio local.
   </para>
@@ -32,7 +36,6 @@
  &reference.imap.imap.connection;
 
 </book>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml