sync with en rev

php · Jan 20, 2025 · 7275ac1 · 7275ac1
1 parent 0548a20
commit 7275ac1
Show file tree

Hide file tree

Showing 9 changed files with 39 additions and 65 deletions.
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: 61c8d3872997a4825e7ed401eb6edbc3251231f9 Maintainer: leonardolara Status: ready --><!-- CREDITS: marabesi,leonardolara -->
+<!-- EN-Revision: a8b6f4dd3a23875b066d4e47ea4a4977a63e0655 Maintainer: leonardolara Status: ready --><!-- CREDITS: marabesi,leonardolara -->
 <chapter xml:id="dom.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
  &extension.constants;
@@ -251,9 +251,9 @@
     </row>
    </thead>
    <tbody>
-    <row xml:id="constant.dom-no-default-ns">
+    <row xml:id="constant.dom-html-no-default-ns">
      <entry>
-      <constant>Dom\NO_DEFAULT_NS</constant>
+      <constant>Dom\HTML_NO_DEFAULT_NS</constant>
       (<type>int</type>)
      </entry>
      <entry>

diff --git a/reference/dom/dom/dom-htmldocument.xml b/reference/dom/dom/dom-htmldocument.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ebbc5bb97c8c063d31309725c0bb93d21213993b Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: a8b6f4dd3a23875b066d4e47ea4a4977a63e0655 Maintainer: leonardolara Status: ready -->
 <reference xml:id="class.dom-htmldocument" 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 Dom\HTMLDocument</title>
  <titleabbrev>Dom\HTMLDocument</titleabbrev>
@@ -41,10 +41,9 @@
     </xi:include>
 
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
-    <classsynopsisinfo role="comment">Not documented yet</classsynopsisinfo>
-    <!--<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-htmldocument')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Dom\\HTMLDocument'])">
+     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-htmldocument')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Dom\\HTMLDocument'])">
      <xi:fallback/>
-    </xi:include>-->
+    </xi:include>
 
     <classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
     <classsynopsisinfo role="comment">Not documented yet</classsynopsisinfo>
@@ -64,6 +63,6 @@
 
  </partintro>
 
-<!-- &reference.dom.dom.entities.htmldocument; -->
+ &reference.dom.dom.entities.htmldocument;
 
 </reference>
diff --git a/reference/dom/domdocument/savexml.xml b/reference/dom/domdocument/savexml.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 40476b2960f884b088d77f38b6bef2c43b662d10 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: a8b6f4dd3a23875b066d4e47ea4a4977a63e0655 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
 <refentry xml:id="domdocument.savexml" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>DOMDocument::saveXML</refname>
@@ -36,13 +36,7 @@
     <varlistentry>
      <term><parameter>options</parameter></term>
      <listitem>
-      <para>
-       Opções adicionais.
-       As opções <link linkend="libxml.constants">LIBXML_NOEMPTYTAG</link>
-       e <link linkend="libxml.constants">LIBXML_NOXMLDECL</link> são suportadas.
-       Antes do PHP 8.3.0, apenas a opção <link linkend="libxml.constants">LIBXML_NOEMPTYTAG</link>
-       é suportada.
-      </para>
+      &dom.parameters.serialize.options;
      </listitem>
     </varlistentry>
    </variablelist>

diff --git a/reference/image/examples.xml b/reference/image/examples.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 10c69571e7dd8a7cc0fbc9f20a55d24b1b1032be Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 9960a09a5705102bf4dd0ce63e03d9ec716d0015 Maintainer: leonardolara Status: ready -->
 
 <chapter xml:id="image.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.examples;
@@ -19,7 +19,6 @@ $orange = imagecolorallocate($im, 220, 210, 60);
 $px     = (imagesx($im) - 7.5 * strlen($string)) / 2;
 imagestring($im, 3, $px, 9, $string, $orange);
 imagepng($im);
-imagedestroy($im);
 
 ?>
 ]]>
@@ -57,10 +56,9 @@ $sy = imagesy($stamp);
 // da foto para calcular o posicionamento do carimbo.
 imagecopy($im, $stamp, imagesx($im) - $sx - $marge_right, imagesy($im) - $sy - $marge_bottom, 0, 0, imagesx($stamp), imagesy($stamp));
 
-// Mostra a imagem e libera a memória
+// Mostra a imagem
 header('Content-type: image/png');
 imagepng($im);
-imagedestroy($im);
 ?>
 ]]>
     </programlisting>
@@ -103,9 +101,8 @@ $sy = imagesy($stamp);
 // Funde o carimbo com a foto usando uma opacidade de 50%
 imagecopymerge($im, $stamp, imagesx($im) - $sx - $marge_right, imagesy($im) - $sy - $marge_bottom, 0, 0, imagesx($stamp), imagesy($stamp), 50);
 
-// Salva a imagem em arquivo e libera memória
+// Salva a imagem em arquivo
 imagepng($im, 'photo_stamp.png');
-imagedestroy($im);
 
 ?>
 ]]>

diff --git a/reference/info/functions/ini-get.xml b/reference/info/functions/ini-get.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c8a8981a9df9a1564a4b9a79e84583d41a7b6ac5 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<!-- EN-Revision: 4c016ab334b90a98258b98e04752af7dc74954cd Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
 <refentry xml:id="function.ini-get" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>ini_get</refname>
@@ -55,37 +55,15 @@
 Considere o php.ini com as seguintes configurações:
 
 display_errors = On
-register_globals = Off
+opcache.enable_cli = Off
 post_max_size = 8M
 */
 
 echo 'display_errors = ' . ini_get('display_errors') . "\n";
-echo 'register_globals = ' . (int) ini_get('register_globals') . "\n";
+echo 'opcache.enable_cli = ' . (int) ini_get('opcache.enable_cli') . "\n";
 echo 'post_max_size = ' . ini_get('post_max_size') . "\n";
 echo 'post_max_size + 1 = ' . (rtrim(ini_get('post_max_size'), 'KMG') + 1) . "\n";
-echo 'post_max_size em bytes = ' . return_bytes(ini_get('post_max_size'));
-
-function return_bytes($val)
-{
-    $val = trim($val);
-    $num = (int) rtrim($val, 'KMG');
-    $last = strtolower($val[strlen($val) - 1]);
-
-    switch ($last) {
-        // O modificador 'G' está disponível
-        case 'g':
-            $num = $num * 1024 * 1024 * 1024;
-            break;
-        case 'm':
-            $num = $num * 1024 * 1024;
-            break;
-        case 'k':
-            $num *= 1024;
-            break;
-    }
-
-    return $num;
-}
+echo 'post_max_size in bytes = ' . ini_parse_quantity(ini_get('post_max_size'));
 
 ?>
 ]]>
@@ -95,7 +73,7 @@ function return_bytes($val)
 <![CDATA[
 
 display_errors = 1
-register_globals = 0
+opcache.enable_cli = 0
 post_max_size = 8M
 post_max_size+1 = 9
 post_max_size em bytes = 8388608
@@ -126,9 +104,9 @@ post_max_size em bytes = 8388608
     <function>ini_get</function> retornará a string exata armazenada no
     arquivo &php.ini; e <emphasis>NÃO</emphasis> o seu equivalente <type>int</type>.
     Tentar funções aritméticas normais com esses valores
-    não trará os resultados esperados. O exemplo acima mostra uma
-    maneira de converter a notação abreviada em bytes, da mesma forma que a
-    fonte PHP o faz.
+    não trará os resultados esperados. A
+    função <function>ini_parse_quantity</function> pode ser usada para converter
+    a notação abreviada em bytes.
    </para>
   </note>
   <note>
@@ -145,6 +123,7 @@ post_max_size em bytes = 8388608
    <simplelist>
     <member><function>get_cfg_var</function></member>
     <member><function>ini_get_all</function></member>
+    <member><function>ini_parse_quantity</function></member>
     <member><function>ini_restore</function></member>
     <member><function>ini_set</function></member>
    </simplelist>

diff --git a/reference/info/functions/ini-parse-quantity.xml b/reference/info/functions/ini-parse-quantity.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 701b63e2cc52908643e16f61ebbc26d9fabbd77a Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<!-- EN-Revision: 4c016ab334b90a98258b98e04752af7dc74954cd Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
 <refentry xml:id="function.ini-parse-quantity" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>ini_parse_quantity</refname>
@@ -77,7 +77,7 @@ var_dump(ini_parse_quantity('10F'));
 ?>
 ]]>
     </programlisting>
-    &example.outputs.similar;
+    &example.outputs;
     <screen>
 <![CDATA[
 

diff --git a/reference/mail/ini.xml b/reference/mail/ini.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: fccc7eb7010120c17732c57f93df1f321245376c Maintainer: leonardolara Status: ready --><!-- CREDITS: diegopires,leonardolara -->
+<!-- EN-Revision: cc5b61f3f889ae2d65a7007e9bdd34981b8aba50 Maintainer: leonardolara Status: ready --><!-- CREDITS: diegopires,leonardolara -->
 <section xml:id="mail.configuration" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.runtime;
  &extension.runtime;
@@ -31,7 +31,7 @@
     <row>
      <entry><link linkend="ini.mail.force_extra_parameters">mail.force_extra_parameters</link></entry>
      <entry>NULL</entry>
-     <entry><constant>INI_SYSTEM</constant>|<constant>INI_PERDIR</constant></entry>
+     <entry><constant>INI_SYSTEM</constant></entry>
      <entry></entry>
     </row>
     <row>
@@ -106,6 +106,11 @@
      parâmetros extras para o binário sendmail. Estes parâmetros sempre substituirão
      o valor do quinto parâmetro da função <function>mail</function>.
     </para>
+    <simpara>
+     Além do comportamento padrão para <constant>INI_SYSTEM</constant>,
+     este valor também pode ser definido com <literal>php_value</literal>
+     no <filename>httpd.conf</filename> (mas isto não é recomendado).
+    </simpara>
    </listitem>
   </varlistentry>
 

diff --git a/reference/spl/splfileobject/setcsvcontrol.xml b/reference/spl/splfileobject/setcsvcontrol.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 61e2ab1eebc37f3a4abe54f05a9984001b7ce59f Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
+<!-- EN-Revision: 4a0ce5d81a6944dd882946ca1a204b1d2efb2416 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
 <refentry xml:id="splfileobject.setcsvcontrol" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
  <refnamediv>
   <refname>SplFileObject::setCsvControl</refname>
@@ -24,7 +24,7 @@
   &reftitle.parameters;
   <variablelist>
    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.fgetcsv')/db:refsect1[@role='parameters']//db:varlistentry[db:term[db:parameter[text()='separator']]]/.)">
-    <xi:fallback><varlistentry><term>></term><listitem><simpara></simpara></listitem></varlistentry></xi:fallback>
+    <xi:fallback><varlistentry><term></term><listitem><simpara></simpara></listitem></varlistentry></xi:fallback>
    </xi:include>
    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.fgetcsv')/db:refsect1[@role='parameters']//db:varlistentry[db:term[db:parameter[text()='enclosure']]]/.)">
     <xi:fallback/>

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: 42bb18bcfef4f715008d00bbdc7ea5203f8ec30a Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: d75036c386e37ce56dafb7607b72aedc3e33fe09 Maintainer: leonardolara Status: ready -->
 <refentry xml:id="function.unserialize" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>unserialize</refname>
@@ -158,6 +158,12 @@
    <informaltable>
     <tgroup cols="2">
      <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
       <row>
        <entry>8.4.0</entry>
        <entry>
@@ -166,12 +172,6 @@
         de <parameter>options</parameter> não for um <type>array</type> de nomes de classes.
        </entry>
       </row>
-      <row>
-       <entry>&Version;</entry>
-       <entry>&Description;</entry>
-      </row>
-     </thead>
-     <tbody>
       <row>
        <entry>8.3.0</entry>
        <entry>