From 790f63af6521908477b285ff753e454e118bb989 Mon Sep 17 00:00:00 2001
From: Gina Peter Banyard <girgias@php.net>
Date: Tue, 12 Nov 2024 14:36:24 +0000
Subject: [PATCH] PHP 8.4: Document reflection changes (#4037)

---
 reference/reflection/reflectionattribute.xml  | 43 +++++++++
 .../reflection/reflectionmethod/construct.xml |  7 ++
 reference/reflection/reflectionproperty.xml   | 89 +++++++++++++++++++
 .../reflection/reflectionproperty/islazy.xml  |  2 +-
 .../setrawvaluewithoutlazyinitialization.xml  |  2 +-
 5 files changed, 141 insertions(+), 2 deletions(-)

diff --git a/reference/reflection/reflectionattribute.xml b/reference/reflection/reflectionattribute.xml
index bfe5432ab93f..f9b9f4dad64c 100644
--- a/reference/reflection/reflectionattribute.xml
+++ b/reference/reflection/reflectionattribute.xml
@@ -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>
+       The name of the attribute.
+      </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>
+        Added <property>ReflectionAttribute::$name</property>.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </section>
+
  </partintro>
 
  &reference.reflection.entities.reflectionattribute;
diff --git a/reference/reflection/reflectionmethod/construct.xml b/reference/reflection/reflectionmethod/construct.xml
index 77ecbc2c353f..23ba43556a88 100644
--- a/reference/reflection/reflectionmethod/construct.xml
+++ b/reference/reflection/reflectionmethod/construct.xml
@@ -18,6 +18,13 @@
    <modifier>public</modifier> <methodname>ReflectionMethod::__construct</methodname>
    <methodparam><type>string</type><parameter>classMethod</parameter></methodparam>
   </constructorsynopsis>
+  <warning>
+   <simpara>
+    The alternative signature is deprecated as of PHP 8.4.0,
+    use <methodname>ReflectionMethod::createFromMethodName</methodname>
+    instead.
+   </simpara>
+  </warning>
   <para>
    Constructs a new <classname>ReflectionMethod</classname>.
   </para>
diff --git a/reference/reflection/reflectionproperty.xml b/reference/reflection/reflectionproperty.xml
index 4a9605c32f3b..73c8ceef43c5 100644
--- a/reference/reflection/reflectionproperty.xml
+++ b/reference/reflection/reflectionproperty.xml
@@ -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>
+        Indicates the property is
+        <link linkend="language.oop5.abstract">abstract</link>.
+        Available as of 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>
+        Available as of 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>
+        Available as of PHP 8.4.0.
+       </simpara>
+      </listitem>
+     </varlistentry>
+
+     <varlistentry xml:id="reflectionproperty.constants.is-virtual">
+      <term><constant>ReflectionProperty::IS_VIRTUAL</constant></term>
+      <listitem>
+       <simpara>
+        Available as of PHP 8.4.0.
+       </simpara>
+      </listitem>
+     </varlistentry>
+
+     <varlistentry xml:id="reflectionproperty.constants.is-final">
+      <term><constant>ReflectionProperty::IS_FINAL</constant></term>
+      <listitem>
+       <simpara>
+        Indicates the property is
+        <link linkend="language.oop5.final">final</link>.
+        Available as of PHP 8.4.0.
+       </simpara>
+      </listitem>
+     </varlistentry>
+
     </variablelist>
     <note>
      <para>
@@ -199,6 +278,16 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        Added <constant>ReflectionProperty::IS_VIRTUAL</constant>,
+        <constant>ReflectionProperty::IS_PRIVATE_SET</constant>,
+        <constant>ReflectionProperty::IS_PROTECTED_SET</constant>,
+        <constant>ReflectionProperty::IS_ABSTRACT</constant>,
+        and <constant>ReflectionProperty::IS_FINAL</constant>.
+       </entry>
+      </row>
       <row>
        <entry>8.0.0</entry>
        <entry>
diff --git a/reference/reflection/reflectionproperty/islazy.xml b/reference/reflection/reflectionproperty/islazy.xml
index 9bd233e056db..d177e9f83eb2 100644
--- a/reference/reflection/reflectionproperty/islazy.xml
+++ b/reference/reflection/reflectionproperty/islazy.xml
@@ -7,7 +7,7 @@
 
  <refsect1 role="description">
   &reftitle.description;
-  <methodsynopsis>
+  <methodsynopsis role="ReflectionProperty">
    <modifier>public</modifier> <type>bool</type><methodname>ReflectionProperty::isLazy</methodname>
    <methodparam><type>object</type><parameter>object</parameter></methodparam>
   </methodsynopsis>
diff --git a/reference/reflection/reflectionproperty/setrawvaluewithoutlazyinitialization.xml b/reference/reflection/reflectionproperty/setrawvaluewithoutlazyinitialization.xml
index da0841125007..176825d34e45 100644
--- a/reference/reflection/reflectionproperty/setrawvaluewithoutlazyinitialization.xml
+++ b/reference/reflection/reflectionproperty/setrawvaluewithoutlazyinitialization.xml
@@ -10,7 +10,7 @@
   <methodsynopsis role="ReflectionProperty">
    <modifier>public</modifier> <type>void</type><methodname>ReflectionProperty::setRawValueWithoutLazyInitialization</methodname>
    <methodparam><type>object</type><parameter>object</parameter></methodparam>
-   <methodparam><type class="union"><type>mixed</type><type>null</type></type><parameter>value</parameter></methodparam>
+   <methodparam><type>mixed</type><parameter>value</parameter></methodparam>
   </methodsynopsis>
   <simpara>
    Sets (changes) the property's value without triggering lazy initialization