repo_zf1/documentation/manual/ja/module_specs/Zend_Reflection-Introduction.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<!-- EN-Revision: 24249 -->
<sect1 id="zend.reflection.introduction">
    <title>導入</title>

    <para>
        <classname>Zend_Reflection</classname>はPHP自身の
        <ulink url="http://php.net/reflection">Reflection <acronym>API</acronym></ulink>に対応する
        <!-- TODO -->drop-in 拡張です。
        いくつかの追加の機能を提供します。
    </para>

    <itemizedlist>
        <listitem><para>
            戻り値の型を取得可能
        </para></listitem>

        <listitem><para>
            メソッドや関数のパラメータの型を取得可能
        </para></listitem>

        <listitem><para>
            クラスのプロパティの型を取得可能
        </para></listitem>

        <listitem><para>
            DocBlockはReflectionクラスでdocblock内部を参照できる利益を得ます。
            これにより、それらの値を取得するだけでなく、定義された注釈タグが何か判断でき、
            短い説明と長い説明を取得できます。
        </para></listitem>

        <listitem><para>
            ファイルはReflectionクラスで<acronym>PHP</acronym>ファイル内部を参照できる利益を得ます。
            これにより、それらの内部を参照するだけでなく、与えられたファイルで定義された関数やクラスが何か判断できます。
        </para></listitem>

        <listitem><para>
            あなた自身の変数とともに、作成した全てのRreflectionツリーのために、
            どんなReflectionクラスも上書き可能
        </para></listitem>
    </itemizedlist>

    <para>
        一般的に、<classname>Zend_Reflection</classname>ではちょうど標準的なReflection <acronym>API</acronym>のように働きますが、
        Reflection <acronym>API</acronym>で定義されていない人工物を参照する追加のメソッドを提供します。
    </para>
</sect1>