documentation/manual/en/module_specs/Zend_Reflection-Introduction.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- Reviewed: no -->
   3 <sect1 id="zend.reflection.introduction">
   4     <title>Introduction</title>
   5
   6     <para>
   7         <classname>Zend_Reflection</classname> is a drop-in extension to <acronym>PHP</acronym>'s
   8         own <ulink url="http://php.net/reflection">Reflection <acronym>API</acronym></ulink>,
   9         providing several additional features:
  10     </para>
  11
  12     <itemizedlist>
  13         <listitem>
  14             <para>
  15                 Ability to retrieve return values types.
  16             </para>
  17         </listitem>
  18
  19         <listitem>
  20             <para>
  21                 Ability to retrieve method and function parameter types.
  22             </para>
  23         </listitem>
  24
  25         <listitem>
  26             <para>
  27                 Ability to retrieve class property types.
  28             </para>
  29         </listitem>
  30
  31         <listitem>
  32             <para>
  33                 DocBlocks gain a Reflection class, allowing introspection of
  34                 docblocks. This provides the ability to determine what annotation
  35                 tags have been defined as well as to retrieve their values, and the
  36                 ability to retrieve the short and long descriptions.
  37             </para>
  38         </listitem>
  39
  40         <listitem>
  41             <para>
  42                 Files gain a Reflection class, allowing introspection of <acronym>PHP</acronym>
  43                 files. This provides the ability to determine what functions and classes
  44                 are defined in a given file, as well as to introspect them.
  45             </para>
  46         </listitem>
  47
  48         <listitem>
  49             <para>
  50                 Ability to override any Reflection class with your own variant, for
  51                 the entire reflection tree you create.
  52             </para>
  53         </listitem>
  54     </itemizedlist>
  55
  56     <para>
  57         In general, <classname>Zend_Reflection</classname> works just like the standard
  58         Reflection <acronym>API</acronym>, but provides a few additional methods for retrieving
  59         artifacts not defined in the Reflection <acronym>API</acronym>.
  60     </para>
  61 </sect1>