sync with en rev

php · Dec 20, 2024 · bba0a08 · bba0a08
1 parent 42afb35
commit bba0a08
Show file tree

Hide file tree

Showing 7 changed files with 121 additions and 56 deletions.
diff --git a/language-snippets.ent b/language-snippets.ent
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 9b68bf2b63200534e022bc65e800cae6c75abf26 Maintainer: leonardolara Status: ready --><!-- CREDITS: adiel, ae, atomotavio, fabioluciano, felipe, klaussilveira, rafaelbernard, leonardolara, fernandowobeto -->
+<!-- EN-Revision: 32caa89e81d180f209425159e2be2f243a3e12cc 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: '>
 
@@ -2677,6 +2677,9 @@ um <constant>E_WARNING</constant> se a chamada a este método falhar
 propriedade <varname linkend="streamwrapper.props.context">streamWrapper::$context</varname>
 será atualizada se um contexto válido for passado para a função invocadora.</para></note>'>
 
+<!ENTITY stream.bucket.param '<parameter>bucket</parameter> agora espera uma instância de <classname>StreamBucket</classname>; anteriormente, esperava um <classname>stdClass</classname>.'>
+<!ENTITY stream.bucket.return 'Esta função agora retorna uma instância de <classname>StreamBucket</classname>; anteriormente, retornava um <classname>stdClass</classname>.'>
+
 <!-- Gmagick -->
 <!ENTITY gmagick.return.success 'Retorna &true; em caso de sucesso.'>
 <!ENTITY gmagick.gmagickexception.throw 'Lança uma exceção

diff --git a/reference/array/functions/array-unshift.xml b/reference/array/functions/array-unshift.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: caf779183ee9860b48c74c8994fb944039b6b56f Maintainer: airtonzanon Status: ready --><!-- CREDITS: narigone,lucasr,felipe,lhsazevedo,airtonzanon -->
+<!-- EN-Revision: 0987e913fcaed76897aeb239c6ed83d765a895e1 Maintainer: leonardolara Status: ready --><!-- CREDITS: narigone,lucasr,felipe,lhsazevedo,airtonzanon,leonardolara -->
 <refentry xml:id="function.array-unshift" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>array_unshift</refname>
@@ -84,13 +84,16 @@
     <programlisting role="php">
 <![CDATA[
 <?php
+
 $cesta = [
     "laranja",
     "banana"
 ];
 
 array_unshift($cesta, "melancia", "morango");
+
 var_dump($cesta);
+
 ?>
 ]]>
     </programlisting>
@@ -121,6 +124,7 @@ array(4) {
     <programlisting role="php">
 <![CDATA[
 <?php
+
 $frutas = [
     'maca' => [
         'McIntosh' => 'vermelho',
@@ -131,6 +135,7 @@ $frutas = [
         'Valencia' => 'laranja',
     ],
 ];
+
 $vegetais = [
     'alface' => [
         'Iceberg' => 'verde',
@@ -147,49 +152,52 @@ $vegetais = [
 ];
 
 array_unshift($frutas, $vegetais);
+
 var_dump($frutas);
+
+?>
 ]]>
     </programlisting>
     &example.outputs;
     <screen role="php">
 <![CDATA[
 array(3) {
-  [0] =>
+  [0]=>
   array(3) {
-    'alface' =>
+    ["alface"]=>
     array(2) {
-      'Iceberg' =>
+      ["Iceberg"]=>
       string(5) "verde"
-      'Butterhead' =>
+      ["Butterhead"]=>
       string(5) "verde"
     }
-    'cenoura' =>
+    ["cenoura"]=>
     array(2) {
-      'Deep Purple Hybrid' =>
+      ["Deep Purple Hybrid"]=>
       string(4) "roxo"
-      'Imperator' =>
+      ["Imperator"]=>
       string(7) "laranja"
     }
-    'pepino' =>
+    ["pepino"]=>
     array(2) {
-      'Kirby' =>
+      ["Kirby"]=>
       string(5) "verde"
-      'Gherkin' =>
+      ["Gherkin"]=>
       string(5) "verde"
     }
   }
-  'maca' =>
+  ["maca"]=>
   array(2) {
-    'McIntosh' =>
+    ["McIntosh"]=>
     string(8) "vermelho"
-    'Granny Smith' =>
+    ["Granny Smith"]=>
     string(5) "verde"
   }
-  'laranja' =>
+  ["laranja"]=>
   array(2) {
-    'Navel' =>
+    ["Navel"]=>
     string(7) "laranja"
-    'Valencia' =>
+    ["Valencia"]=>
     string(7) "laranja"
   }
 }

diff --git a/reference/openssl/setup.xml b/reference/openssl/setup.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: d5da0808c4d6343eb8f0099307d3139102a6f4bf Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 3fa666ce023c7f5005cae5c3bf4fbef2b47ef9d1 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
 
 <chapter xml:id="openssl.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.setup;
@@ -12,7 +12,8 @@
    xlink:href="&url.openssl;">OpenSSL</link>.
    O PHP 7.0 requer OpenSSL &gt;= 0.9.8, &lt; 1.2. O PHP 7.1-8.0 requer
    OpenSSL &gt;= 1.0.1, &lt; 3.0. O PHP &gt;= 8.1 requer OpenSSL
-   &gt;= 1.0.2, &lt; 4.0.
+   &gt;= 1.0.2, &lt; 4.0. PHP &gt;= 8.4 requer OpenSSL
+   &gt;= 1.1.1, &lt; 4.0.
   </para>
   <warning>
    <para>

diff --git a/reference/stream/functions/stream-bucket-append.xml b/reference/stream/functions/stream-bucket-append.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 54b06426830ad1c96a042a848f40916b42f30d48 Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 32caa89e81d180f209425159e2be2f243a3e12cc Maintainer: leonardolara Status: ready -->
 <!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
 <refentry xml:id="function.stream-bucket-append" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -13,13 +13,33 @@
   <methodsynopsis>
    <type>void</type><methodname>stream_bucket_append</methodname>
    <methodparam><type>resource</type><parameter>brigade</parameter></methodparam>
-   <methodparam><type>object</type><parameter>bucket</parameter></methodparam>
+   <methodparam><type>StreamBucket</type><parameter>bucket</parameter></methodparam>
   </methodsynopsis>
 
   &warn.undocumented.func;
 
  </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>&stream.bucket.param;</entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
 </refentry>
 
 <!-- Keep this comment at the end of the file

diff --git a/reference/stream/functions/stream-bucket-make-writeable.xml b/reference/stream/functions/stream-bucket-make-writeable.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 3561c702e7bea3265a72bbd598d0ef079db60145 Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 32caa89e81d180f209425159e2be2f243a3e12cc Maintainer: leonardolara Status: ready -->
 <!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
 <refentry xml:id="function.stream-bucket-make-writeable" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -12,7 +12,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type class="union"><type>object</type><type>null</type></type><methodname>stream_bucket_make_writeable</methodname>
+   <type class="union"><type>StreamBucket</type><type>null</type></type><methodname>stream_bucket_make_writeable</methodname>
    <methodparam><type>resource</type><parameter>brigade</parameter></methodparam>
   </methodsynopsis>
   <para>
@@ -40,34 +40,30 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Retorna um objeto bucket com as propriedades listadas abaixo ou &null;.
-   <variablelist>
-    <varlistentry>
-     <term>
-      <property>data</property>
-      (<type>string</type>)
-     </term>
-     <listitem>
-      <para>
-       <parameter>data</parameter> <literal>bucket</literal> A string atual no bucket.
-      </para>
-     </listitem>
-    </varlistentry>
-    <varlistentry>
-     <term>
-      <property>datalen</property>
-      (<type>integer</type>)
-     </term>
-     <listitem>
-      <para>
-       <parameter>datalen</parameter> <literal>bucket</literal> O comprimento da string no bucket.
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
+   Retorna um objeto bucket ou &null;.
   </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>&stream.bucket.return;</entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -78,7 +74,6 @@
   </para>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

diff --git a/reference/stream/functions/stream-bucket-new.xml b/reference/stream/functions/stream-bucket-new.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 32caa89e81d180f209425159e2be2f243a3e12cc Maintainer: leonardolara Status: ready -->
 <!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
 <refentry xml:id="function.stream-bucket-new" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -11,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>object</type><methodname>stream_bucket_new</methodname>
+   <type>StreamBucket</type><methodname>stream_bucket_new</methodname>
    <methodparam><type>resource</type><parameter>stream</parameter></methodparam>
    <methodparam><type>string</type><parameter>buffer</parameter></methodparam>
   </methodsynopsis>
@@ -20,8 +20,27 @@
 
  </refsect1>
 
-</refentry>
+ <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>&stream.bucket.return;</entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
 
+</refentry>
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

diff --git a/reference/stream/functions/stream-bucket-prepend.xml b/reference/stream/functions/stream-bucket-prepend.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 54b06426830ad1c96a042a848f40916b42f30d48 Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 32caa89e81d180f209425159e2be2f243a3e12cc Maintainer: leonardolara Status: ready -->
 <!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
 <refentry xml:id="function.stream-bucket-prepend" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -13,7 +13,7 @@
   <methodsynopsis>
    <type>void</type><methodname>stream_bucket_prepend</methodname>
    <methodparam><type>resource</type><parameter>brigade</parameter></methodparam>
-   <methodparam><type>object</type><parameter>bucket</parameter></methodparam>
+   <methodparam><type>StreamBucket</type><parameter>bucket</parameter></methodparam>
   </methodsynopsis>
   <para>
     Esta função pode ser chamada para adicionar um bucket ao início da brigada. É
@@ -50,6 +50,26 @@
   </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>&stream.bucket.param;</entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -81,7 +101,6 @@ print  file_get_contents('php://filter/read=test/resource=foo');
   </para>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml