Содержание

• Введение
• Интерфейс Reflector
• Класс ReflectionException
• Класс ReflectionFunction
• Класс ReflectionParameter
• Класс ReflectionClass
• Класс ReflectionObject
• Класс ReflectionMethod
• Класс ReflectionProperty
• Класс ReflectionExtension
• Наследование классов Reflection

Введение

В PHP 5 имеется полный набор Reflection API, который предоставляет возможность проводить реверс-инжиниринг классов, интерфейсов, функций, методов, а также расширений. В дополнение к этому, Reflection API предоставляет средства для извлечения комментариев для функций, классов и методов.

Reflection API - это объектно-ориентированное расширение для Zend Engine, состоящее из следующих классов:

Замечание: Более подробно эти классы рассматриваются в следующих главах.

Class [ <internal> class Exception ] {

  - Constants [0] {
  }

  - Static properties [0] {
  }

  - Static methods [0] {
  }

  - Properties [6] {
    Property [ <default> protected $message ]
    Property [ <default> private $string ]
    Property [ <default> protected $code ]
    Property [ <default> protected $file ]
    Property [ <default> protected $line ]
    Property [ <default> private $trace ]
  }

  - Methods [9] {
    Method [ <internal> final private method __clone ] {
    }

    Method [ <internal, ctor> public method __construct ] {

      - Parameters [2] {
        Parameter #0 [ <optional> $message ]
        Parameter #1 [ <optional> $code ]
      }
    }

    Method [ <internal> final public method getMessage ] {
    }

    Method [ <internal> final public method getCode ] {
    }

    Method [ <internal> final public method getFile ] {
    }

    Method [ <internal> final public method getLine ] {
    }

    Method [ <internal> final public method getTrace ] {
    }

    Method [ <internal> final public method getTraceAsString ] {
    }

    Method [ <internal> public method __toString ] {
    }
  }
}

     

Reflector

Reflector - это интерфейс, который реализуется всеми экспортируемыми классами Reflection.

ReflectionException

ReflectionException наследует стандартный класс Exception и выбрасывается Reflection API, он не реализует никаких специальных методов или свойств.

ReflectionFunction

Класс ReflectionFunction позволяет проводить реверс-инжиниринг функций.

Родительский класс ReflectionFunctionAbstract имеет такие же методы, за исключением invoke(), invokeArgs(), export() и isDisabled().

Замечание: getNumberOfParameters() и getNumberOfRequiredParameters() были добавлены в PHP 5.0.3, а invokeArgs() был добавлен в PHP 5.1.0.

Для анализа функции необходимо создать экземпляр класса ReflectionFunction.

Замечание: Метод invoke() принимает переменное число аргументов, которые передаются в функцию, также, как в call_user_func().

ReflectionParameter

Класс ReflectionParameter возвращает информацию о параметрах функции или метода.

Замечание: getDefaultValue(), isDefaultValueAvailable() и isOptional() были добавлены в PHP 5.0.3, а isArray() был добавлен в PHP 5.1.0. getDeclaringFunction() и getPosition() были добавлены в PHP 5.2.3.

Для анализа параметров функции необходимо создать экземпляр класса ReflectionFunction или ReflectionMethod и затем использовать метод getParameters() для получения массива параметров.

ReflectionClass

Класс ReflectionClass позволяет проводить реверс-инжиниринг классов и интерфейсов.

Замечание: hasConstant(), hasMethod(), hasProperty(), getStaticPropertyValue() и setStaticPropertyValue() были добавлены в PHP 5.1.0, а newInstanceArgs() был добавлен в PHP 5.1.3.

Для анализа класса необходимо создать экземпляр класса ReflectionClass.

Замечание: Метод newInstance() принимает переменное число аргументов, которые передаются в функцию, также, как в call_user_func().

Замечание: $class = new ReflectionClass('Foo'); $class->isInstance($arg) эквивалентно $arg instanceof Foo или is_a($arg, 'Foo').

ReflectionObject

Класс ReflectionObject позволяет проводить реверс-инжиниринг объектов.

ReflectionMethod

Класс ReflectionMethod позволяет проводить реверс-инжиниринг методов.

Для анализа метода класса необходимо создать экземпляр класса ReflectionMethod.

Замечание: Попытка вызова закрытого, защищенного или абстрактного метода приведет к выбросу исключения из метода invoke().

Замечание: При вызове статических методов нужно передать NULL в качестве первого аргумента invoke(). Для нестатических методов нужно передавать экземпляр класса.

ReflectionProperty

Класс ReflectionProperty позволяет проводить реверс-инжиниринг свойств класса.

Замечание: getDocComment() был добавлен в PHP 5.1.0.

Для анализа свойства класса необходимо создать экземпляр класса ReflectionProperty.

Замечание: Попытка вызова закрытого или защищенного свойства класса приведет к выбросу исключения.

ReflectionExtension

Класс ReflectionExtension позволяет проводить реверс-инжиниринг расширений. Получить список всех загруженных расширений можно при помощи get_loaded_extensions().

Для анализа расширения необходимо создать экземпляр класса ReflectionExtension. Затем вы сможете вызвать любой из методов, описанных выше.

Наследование классов Reflection

В случае, если вам требуется создать специализированные версии встроенных классов (например, для подсветки HTML при экспорте использовать свойства классов может быть более удобно, чем методы), вы можете наследовать их.

Замечание: Внимание! Если вы переписываете конструктор, то не забудьте вызывать конструктор родителя _перед_ любым кодом, который вы затем добавите. В случае невыполнения этого условия результат будет следующим: Fatal error: Internal error: Failed to retrieve the reflection object