sync with en rev

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

Hide file tree

Showing 16 changed files with 415 additions and 58 deletions.
diff --git a/reference/reflection/reflectionattribute.xml b/reference/reflection/reflectionattribute.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 790f63af6521908477b285ff753e454e118bb989 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
 <reference xml:id="class.reflectionattribute" 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 ReflectionAttribute</title>
@@ -39,6 +39,13 @@
      <varname linkend="reflectionattribute.constants.is-instanceof">ReflectionAttribute::IS_INSTANCEOF</varname>
     </fieldsynopsis>
 
+    <classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
+    <fieldsynopsis>
+     <modifier>public</modifier>
+     <type>string</type>
+     <varname linkend="reflectionattribute.props.name">name</varname>
+    </fieldsynopsis>
+
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.reflectionattribute')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='ReflectionAttribute'])">
      <xi:fallback/>
@@ -51,6 +58,20 @@
 
   </section>
 
+  <section xml:id="reflectionattribute.props">
+   &reftitle.properties;
+   <variablelist>
+    <varlistentry xml:id="reflectionattribute.props.name">
+     <term><varname>name</varname></term>
+     <listitem>
+      <simpara>
+       O nome do atributo.
+      </simpara>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </section>
+
   <!-- {{{ ReflectionAttribute constants -->
   <section xml:id="reflectionattribute.constants">
    &reftitle.constants;
@@ -80,6 +101,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>
+        Adicionado <property>ReflectionAttribute::$name</property>.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </section>
+
  </partintro>
 
  &reference.reflection.entities.reflectionattribute;

diff --git a/reference/reflection/reflectionfunctionabstract/getclosurescopeclass.xml b/reference/reflection/reflectionfunctionabstract/getclosurescopeclass.xml
@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ca840c9a6d665e60a7de48b57a5b6440c0d3b0c1 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: adiel,fernandowobeto -->
-<refentry xml:id="reflectionfunctionabstract.getclosurescopeclass" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+<!-- EN-Revision: 348789addeedc32858ec0e29ec44fada391aecb3 Maintainer: leonardolara Status: ready --><!-- CREDITS: adiel,fernandowobeto,leonardolara -->
+<refentry xml:id="reflectionfunctionabstract.getclosurescopeclass" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
  <refnamediv>
   <refname>ReflectionFunctionAbstract::getClosureScopeClass</refname>
-  <refpurpose>Retorna a classe de escopo associada ao closure</refpurpose>
+  <refpurpose>Retorna a classe correspondente ao escopo dentro de uma closure</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -12,10 +12,11 @@
    <modifier>public</modifier> <type class="union"><type>ReflectionClass</type><type>null</type></type><methodname>ReflectionFunctionAbstract::getClosureScopeClass</methodname>
    <void/>
   </methodsynopsis>
-  <para>
-   Obtém a classe que envolve a declaração de closure.
-  </para>
-
+  <simpara>
+   Retorna a classe como uma <classname>ReflectionClass</classname> que
+   corresponde ao escopo dentro de uma
+   <classname>Closure</classname>.
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">
@@ -25,11 +26,26 @@
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
-   Retorna a classe ou &null; se a função não for um clsoure ou se não houver classe envolvente.
-  </para>
+  <simpara>
+   Retorna uma <classname>ReflectionClass</classname> que corresponde à classe
+   cujo escopo está sendo usado dentro da <classname>Closure</classname>.
+   Se a função não for uma closure ou se tiver escopo global, retornadois
+   &null;.
+  </simpara>
  </refsect1>
 
+ <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('reflectionfunctionabstract.getclosurecalledclass')/db:refsect1[@role='examples']/.)">
+  <xi:fallback/>
+ </xi:include>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><methodname>ReflectionFunctionAbstract::getClosureCalledClass</methodname></member>
+   <member><methodname>ReflectionFunctionAbstract::getClosureThis</methodname></member>
+   <member><xref linkend="language.oop5.late-static-bindings" /></member>
+  </simplelist>
+ </refsect1>
 
 </refentry>
 <!-- Keep this comment at the end of the file

diff --git a/reference/reflection/reflectionfunctionabstract/getclosurethis.xml b/reference/reflection/reflectionfunctionabstract/getclosurethis.xml
@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ca840c9a6d665e60a7de48b57a5b6440c0d3b0c1 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: adiel,fernandowobeto -->
-<refentry xml:id="reflectionfunctionabstract.getclosurethis" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+<!-- EN-Revision: 348789addeedc32858ec0e29ec44fada391aecb3 Maintainer: leonardolara Status: ready --><!-- CREDITS: adiel,fernandowobeto,leonardolara -->
+<refentry xml:id="reflectionfunctionabstract.getclosurethis" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
  <refnamediv>
   <refname>ReflectionFunctionAbstract::getClosureThis</refname>
-  <refpurpose>Retorna este ponteiro vinculado ao Closure</refpurpose>
+  <refpurpose>Retorna o objeto que corresponde a $this dentro de uma closure</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -25,12 +25,26 @@
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
-   Retorna o ponteiro <varname>$this</varname>.
-   Retorna &null; em caso de erro.
-  </para>
+  <simpara>
+   Retorna a instância do objeto representado por <varname>$this</varname> dentro
+   da <classname>Closure</classname>.
+   Se a função não for uma closure ou se não tiver <varname>$this</varname>,
+   retorna &null;.
+  </simpara>
  </refsect1>
 
+ <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('reflectionfunctionabstract.getclosurecalledclass')/db:refsect1[@role='examples']/.)">
+  <xi:fallback/>
+ </xi:include>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><methodname>ReflectionFunctionAbstract::getClosureCalledClass</methodname></member>
+   <member><methodname>ReflectionFunctionAbstract::getClosureScopeClass</methodname></member>
+   <member><xref linkend="language.oop5.late-static-bindings" /></member>
+  </simplelist>
+ </refsect1>
 
 </refentry>
 <!-- Keep this comment at the end of the file

diff --git a/reference/reflection/reflectiongenerator/getfunction.xml b/reference/reflection/reflectiongenerator/getfunction.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ec2fe9a592f794978114ef5021db9f1d00c2e05d Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 812143d1de2e2c822f815090a40b395b512db751 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
 <refentry xml:id="reflectiongenerator.getfunction" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>ReflectionGenerator::getFunction</refname>
@@ -32,7 +32,30 @@
   </para>
  </refsect1>
 
-  <refsect1 role="examples">
+ <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>
+       <methodname>ReflectionGenerator::getFunction</methodname>
+       agora pode ser chamada depois que o gerador terminar a execução.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
+ <refsect1 role="examples">
   &reftitle.examples;
   <para>
    <example>

diff --git a/reference/reflection/reflectionmethod/construct.xml b/reference/reflection/reflectionmethod/construct.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ec2fe9a592f794978114ef5021db9f1d00c2e05d Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 790f63af6521908477b285ff753e454e118bb989 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
 <refentry xml:id="reflectionmethod.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>ReflectionMethod::__construct</refname>
@@ -18,6 +18,13 @@
    <modifier>public</modifier> <methodname>ReflectionMethod::__construct</methodname>
    <methodparam><type>string</type><parameter>classMethod</parameter></methodparam>
   </constructorsynopsis>
+  <warning>
+   <simpara>
+    A assinatura alternativa foi descontinuada a partir do PHP 8.4.0,
+    use <methodname>ReflectionMethod::createFromMethodName</methodname>
+    em seu lugar.
+   </simpara>
+  </warning>
   <para>
    Constrói um novo <classname>ReflectionMethod</classname>.
   </para>

diff --git a/reference/reflection/reflectionproperty.xml b/reference/reflection/reflectionproperty.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 790f63af6521908477b285ff753e454e118bb989 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
 <reference xml:id="class.reflectionproperty" 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 ReflectionProperty</title>
@@ -62,6 +62,36 @@
      <type>int</type>
      <varname linkend="reflectionproperty.constants.is-private">ReflectionProperty::IS_PRIVATE</varname>
     </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>public</modifier>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="reflectionproperty.constants.is-abstract">ReflectionProperty::IS_ABSTRACT</varname>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>public</modifier>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="reflectionproperty.constants.is-protected-set">ReflectionProperty::IS_PROTECTED_SET</varname>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>public</modifier>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="reflectionproperty.constants.is-private-set">ReflectionProperty::IS_PRIVATE_SET</varname>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>public</modifier>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="reflectionproperty.constants.is-virtual">ReflectionProperty::IS_VIRTUAL</varname>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>public</modifier>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="reflectionproperty.constants.is-final">ReflectionProperty::IS_FINAL</varname>
+    </fieldsynopsis>
 
     <classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
     <fieldsynopsis>
@@ -176,6 +206,55 @@
       </listitem>
      </varlistentry>
 
+     <varlistentry xml:id="reflectionproperty.constants.is-abstract">
+      <term><constant>ReflectionProperty::IS_ABSTRACT</constant></term>
+      <listitem>
+       <simpara>
+        Indica que a propriedade é
+        <link linkend="language.oop5.abstract">abstrata</link>.
+        Disponível a partir do PHP 8.4.0.
+       </simpara>
+      </listitem>
+     </varlistentry>
+
+     <varlistentry xml:id="reflectionproperty.constants.is-protected-set">
+      <term><constant>ReflectionProperty::IS_PROTECTED_SET</constant></term>
+      <listitem>
+       <simpara>
+        Disponível a partir do PHP 8.4.0.
+       </simpara>
+      </listitem>
+     </varlistentry>
+
+     <varlistentry xml:id="reflectionproperty.constants.is-private-set">
+      <term><constant>ReflectionProperty::IS_PRIVATE_SET</constant></term>
+      <listitem>
+       <simpara>
+        Disponível a partir do PHP 8.4.0.
+       </simpara>
+      </listitem>
+     </varlistentry>
+
+     <varlistentry xml:id="reflectionproperty.constants.is-virtual">
+      <term><constant>ReflectionProperty::IS_VIRTUAL</constant></term>
+      <listitem>
+       <simpara>
+        Disponível a partir do PHP 8.4.0.
+       </simpara>
+      </listitem>
+     </varlistentry>
+
+     <varlistentry xml:id="reflectionproperty.constants.is-final">
+      <term><constant>ReflectionProperty::IS_FINAL</constant></term>
+      <listitem>
+       <simpara>
+        Indica que a propriedade é
+        <link linkend="language.oop5.final">final</link>.
+        Disponível a partir do PHP 8.4.0.
+       </simpara>
+      </listitem>
+     </varlistentry>
+
     </variablelist>
     <note>
      <para>
@@ -199,6 +278,16 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        Adicionadas <constant>ReflectionProperty::IS_VIRTUAL</constant>,
+        <constant>ReflectionProperty::IS_PRIVATE_SET</constant>,
+        <constant>ReflectionProperty::IS_PROTECTED_SET</constant>,
+        <constant>ReflectionProperty::IS_ABSTRACT</constant>,
+        e <constant>ReflectionProperty::IS_FINAL</constant>.
+       </entry>
+      </row>
       <row>
        <entry>8.0.0</entry>
        <entry>

diff --git a/reference/spl/functions/spl-autoload-call.xml b/reference/spl/functions/spl-autoload-call.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 60809ebcf7d0c261b2f00e093e4fab70326ffc7b Maintainer: fernandowobeto Status: ready --><!-- CREDITS: diogo -->
+<!-- EN-Revision: afb063c84d5d707ae329cd94474eee42a6fa82ff Maintainer: leonardolara Status: ready --><!-- CREDITS: diogo,fernandowobeto,leonardolara -->
 <refentry xml:id="function.spl-autoload-call" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>spl_autoload_call</refname>
@@ -12,7 +12,7 @@
    <methodparam><type>string</type><parameter>class</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Esta função pode ser usada para procurar manualmente por uma classe ou interface
+   Esta função pode ser usada para procurar manualmente por uma classe, interface, trait ou enumeração
    usando as funções __autoload registradas.
   </para>
  </refsect1>

diff --git a/reference/spl/functions/spl-autoload.xml b/reference/spl/functions/spl-autoload.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 450d2085da9bba991afb9c68d9c94fc06a67a8a7 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
+<!-- EN-Revision: 87ea6d1675fe601a5dddf4538a465c3af664cd10 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
 <refentry xml:id="function.spl-autoload" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>spl_autoload</refname>
@@ -29,7 +29,9 @@
      <term><parameter>class</parameter></term>
      <listitem>
       <para>
-       O nome da classe (e namespace) sendo instanciada.
+       O nome da classe sendo instanciada.
+       Ao chamar a função, o nome da classe com o namespace é passado ao parâmetro.
+       O parâmetro <parameter>class</parameter> não conterá a barra invertida inicial de um identificador completamente qualificado.
       </para>
      </listitem>
     </varlistentry>