Reflection deprecation

reference/reflection/reflectionfunctionabstract/getparameters.xml

@@ -14,7 +14,8 @@
    <void />
   </methodsynopsis>
   <para>
-   Get the parameters as an array of <type>ReflectionParameter</type>.
+  Get the parameters as an array of <type>ReflectionParameter</type>,
+  in the order in which they are defined in the source.
   </para>
 
   &warn.undocumented.func;

reference/reflection/reflectionnamedtype/isbuiltin.xml

@@ -14,7 +14,8 @@
    <void />
   </methodsynopsis>
   <para>
-   Checks if the type is a built-in type in PHP.
+   Checks if the type is a built-in type in PHP. A built-in type is any type that
+   is not a class, interface, or trait.
   </para>
  </refsect1>
 

reference/reflection/reflectionparameter/getclass.xml

@@ -36,7 +36,13 @@
    or the declared type is not a class or interface.
   </para>
  </refsect1>
-
+
+ <section>
+  As of PHP 8.0.0 this function is deprecated and not recommended. Instead, use
+  <methodname>ReflectionParameter::getType</methodname> to get the <class>ReflectionType</class>
+  of the parameter, then interrogate that object to determine the parameter type.
+ </section>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>

reference/reflection/reflectionparameter/gettype.xml

@@ -92,6 +92,31 @@ NULL
 ]]>
     </screen>
    </example>
+   <example>
+   <title><methodname>ReflectionParameter::getType</methodname> Usage in PHP 8.0.0 and later</title>
+    <para>
+     As of PHP 8.0.0, this method may return a <classname>ReflectionNamedType</classname> instance or
+     a <classname>ReflectionUnionType</classname> instance.  The latter is a collection of the former.
+     To analyze a type, it is often convenient to normalize it to an array of <classname>ReflectionNamedType</classname>
+     objects.  The following function will return an array of <literal>0</literal> or more <classname>ReflectionNamedType</classname>
+     instances.
+    </para>
+   <programlisting role="php">
+<![CDATA[
+<?php
+function getAllTypes(ReflectionParameter $reflectionParameter): array {
+    $reflectionType = $reflectionParameter->getType();
+
+    if (!$reflectionType) return [];
+
+    return $reflectionType instanceof ReflectionUnionType
+        ? $reflectionType->getTypes()
+        : [$reflectionType];
+}
+?>
+]]>
+   </programlisting>
+  </example>
   </para>
  </refsect1>
 

reference/reflection/reflectionparameter/isarray.xml

@@ -34,6 +34,32 @@
   </para>
  </refsect1>
 
+ <section>
+  As of PHP 8.0.0, the following code will report if a type supports arrays,
+  including as part of a union.
+ </section>
+
+ <example>
+  <title>PHP 8.0.0 equivalent</title>
+  <programlisting role="php">
+<![CDATA[
+<?php
+function allowsArray(ReflectionParameter $reflectionParameter): bool {
+    $reflectionType = $reflectionParameter->getType();
+
+    if (!$reflectionType) return false;
+
+    $types = $reflectionType instanceof ReflectionUnionType
+        ? $reflectionType->getTypes()
+        : [$reflectionType];
+
+   return in_array('array', array_map(fn(ReflectionNamedType $t) => $t->getName(), $types));
+}
+?>
+]]>
+  </programlisting>
+ </example>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>

reference/reflection/reflectionparameter/iscallable.xml

@@ -38,6 +38,31 @@
   </para>
  </refsect1>
 
+ <section>
+  As of PHP 8.0.0, the following code will report if a type supports callables,
+  including as part of a union.
+ </section>
+
+ <example>
+  <title>PHP 8.0.0 equivalent</title>
+  <programlisting role="php">
+<![CDATA[
+<?php
+function allowsCallable(ReflectionParameter $reflectionParameter): bool {
+    $reflectionType = $reflectionParameter->getType();
+
+    if (!$reflectionType) return false;
+
+    $types = $reflectionType instanceof ReflectionUnionType
+        ? $reflectionType->getTypes()
+        : [$reflectionType];
+
+   return in_array('callable', array_map(fn(ReflectionNamedType $t) => $t->getName(), $types));
+}
+?>
+]]>
+  </programlisting>
+ </example>
 
 </refentry>