Php what is reflection class

What Are the Reflection Classes in php? [duplicate]

Finding documentation is one problem, but the quality of documentation is another, equally important, problem. Most developers know the value of accurately commented code, but when i am in the middle of coding, the meaning of your code always seems crystal clear, so comments appear superfluous. Besides, there’s always the ultimate excuse for the absence of internal documentation—i want to keep file size small to reduce download time. This is often the situation with internal documentation, but external documentation fares no better. It doesn’t make sense to write it as i go because things always change, but, by the time i’ve finished coding, documentation is the furthest thing from my mind. However: I searched in google and I found a solution called Reflection Classes Could any one describe it briefly plz ?

“i want to keep file size small to reduce download time.” that only applies to files which are downloaded by users. Which is only JS, not PHP or other server-side code. And if you worry about JS file sizes, you should probably use minification instead.

user, the most part of your question is sharing some thoughts about documentation. And only the last sentence is your question? Would you mind to edit your question that it’s more on topic?

I don’t think this should have been edited. The extra text is maybe 30 seconds worth of reading but provides insight on exactly what he’s wanting the Reflection Classes for. It also provides insight into the fact that it appears his problem isn’t gathering documentation but instead writing it.

4 Answers 4

This group of classes was created for the express purpose of introspecting other classes. These classes make it possible to examine the properties of other classes by retrieving metadata about classes; you can even use them to examine the reflection classes themselves.

Reflection provides information about the modifiers of a class or interface—whether that class is final or static, for example.

It can also reveal all the methods and data members of a class and all the modifiers applied to them.

Parameters passed to methods can also be introspected and the names of variables exposed. Through reflection it is possible to automate the documentation of built-in classes or user-defined classes.

It turns out that the central repository of information about classes was right in front of us all the time. PHP can tell us all about itself through the mirror of the reflection classes.

The reflection group of classes or Application Programming Interface (API) is made up of a number of different classes and one

class Reflection interface Reflector class ReflectionException extends Exception class ReflectionFunction implements Reflector class ReflectionParameter implements Reflector class ReflectionMethod extends ReflectionFunction class ReflectionClass implements Reflector class ReflectionObject extends ReflectionClass class ReflectionProperty implements Reflector class ReflectionExtension implements Reflector 

Look at this list, there is actually no class ancestor common to all reflection classes. On the other hand, the Reflector interface is shared by all classes except Reflection and ReflectionException. ReflectionMethod extendsReflectionFunction, ReflectionObject extends ReflectionClass , and ReflectionException extends Exception.

ReflectionObject shares all the methods of ReflectionClass; the only difference between these classes is that ReflectionObject takes a class instance rather than a class name as a parameter—using an instance, you can introspect a class without knowing anything about it, even its name.

Источник

Класс Reflection

Here is a code snippet for some of us who are just beginning with reflection. I have a simple class below with two properties and two methods. We will use reflection classes to populate the properties dynamically and then print them:

class A
public $one = » ;
public $two = » ;

//Constructor
public function __construct ()
//Constructor
>

//print variable one
public function echoOne ()
echo $this -> one . «\n» ;
>

//print variable two
public function echoTwo ()
echo $this -> two . «\n» ;
>
>

//Instantiate the object
$a = new A ();

//Instantiate the reflection object
$reflector = new ReflectionClass ( ‘A’ );

//Now get all the properties from class A in to $properties array
$properties = $reflector -> getProperties ();

$i = 1 ;
//Now go through the $properties array and populate each property
foreach( $properties as $property )
//Populating properties
$a -> < $property ->getName ()>= $i ;
//Invoking the method to print what was populated
$a -> < "echo" . ucfirst ( $property ->getName ())>(). «\n» ;

• Reflection
  • Введение
  • Установка и настройка
  • Предопределённые константы
  • Примеры
  • Расширение
  • Reflection
  • ReflectionClass
  • ReflectionClassConstant
  • ReflectionEnum
  • ReflectionEnumUnitCase
  • ReflectionEnumBackedCase
  • ReflectionZendExtension
  • ReflectionExtension
  • ReflectionFunction
  • ReflectionFunctionAbstract
  • ReflectionMethod
  • ReflectionNamedType
  • ReflectionObject
  • ReflectionParameter
  • ReflectionProperty
  • ReflectionType
  • ReflectionUnionType
  • ReflectionGenerator
  • ReflectionFiber
  • ReflectionIntersectionType
  • ReflectionReference
  • ReflectionAttribute
  • Reflector
  • ReflectionException

  Источник

  Введение в PHP Reflection API

  Привет, Хабр! Представляю вашему вниманию перевод статьи «Introduction to PHP Reflection API» автора Mustafa Magdi.

  Как в PHP анализировать структуру данных

  

  Вступление

  Когда я начал программировать на PHP, то не знал о возможностях Reflection API. Главная причина в том, что мне не нужно было проектировать свои простые классы, модули или даже пакеты. Затем я обнаружил, что это играет главную роль во многих областях. В статье мы рассмотрим Reflection API по следующим пунктам:

  1. Что такое Reflection API

  В информатике отражение или рефлексия (холоним интроспекции, англ. reflection) означает процесс, во время которого программа может отслеживать и модифицировать собственную структуру и поведение во время выполнения. — Wikipedia.

  Что означает возможность остановить и взглянуть внутрь своего кода ( reverse-engineering )? Давайте посмотрим на следующий фрагмент кода:

  /** * Class Profile */ class Profile < /** * @return string */ public function getUserName(): string < return 'Foo'; >> 

  Класс Profile — чёрный ящик. Используя Reflection API вы сможете прочитать, что там находится внутри:

  // инициализация $reflectionClass = new ReflectionClass('Profile'); // получить имя класса var_dump($reflectionClass->getName()); => output: string(7) "Profile" // получить документацию класса var_dump($reflectionClass->getDocComment()); => output: string(24) "/** * Class Profile */" 

  Таким образом ReflectionClass выступает аналитиком для нашего класса Profile, и в этом состоит главная идея Reflection API.

  PHP даёт вам ключ к любому запертому ящику, таким образом мы имеем ключи
  для следующего:

  ReflectionClass: сообщает информацию о классе.
  ReflectionFunction: сообщает информацию о функции.
  ReflectionParameter: извлекает информацию о параметрах функции или метода.
  ReflectionClassConstant: сообщает информацию о константе класса.

  Полный список вы можете изучить на php.net

  2. Установка и конфигурирование

  Для использования классов Reflection API нет необходимости что-либо устанавливать или настраивать, так как они входят в состав ядра PHP.

  3. Примеры использования

  Далее представлено несколько примеров того, как мы можем использовать Reflection API:

  Пример 1:
  Получить родительский класс для определённого класса:

  // дочерний класс class Child extends Profile < >$class = new ReflectionClass('Child'); // получаем список всех родителей print_r($class->getParentClass()); // ['Profile'] 

  Пример 2:
  Получить документацию метода getUserName() :

  $method = new ReflectionMethod('Profile', 'getUserName'); var_dump($method->getDocComment()); => output: string(33) "/** * @return string */" 

  Пример 3:
  Может использоваться как instanceOf и is_a() для валидации объектов:

  $class = new ReflectionClass('Profile'); $obj = new Profile(); var_dump($class->isInstance($obj)); // bool(true) // такой же как var_dump(is_a($obj, 'Profile')); // bool(true) // такой же как var_dump($obj instanceof Profile); // bool(true) 

  Пример 4:
  В некоторых ситуациях вы можете застрять с unit-тестированием и задаться вопросом: «Как я могу протестировать закрытую функцию?!»

  Не беспокойтесь, вот хитрость:

  // добавим закрытый метод getUserName() private function getUserName(): string < return 'Foo'; >$method = new ReflectionMethod('Profile', 'getUserName'); // проверим является ли метод закрытым и сделаем его доступным if ($method->isPrivate()) < $method->setAccessible(true); > echo $method->invoke(new Profile()); // Foo 

  Предыдущие примеры довольно просты, но есть другие примеры, в которых вы можете увидеть, как Reflection API используется более обширно:

  • Генератор документации к API: пакет lavarel-apidoc-generator широко использует ReflectionClass и ReflrectionMethod для получения и последующей обработки информации о блоках документации классов и методов, и оформления этих блоков кода.
  • Dependency Injection Container: проверить всю тему вы можете здесь

  4. Заключение

  PHP предоставляет полноценный Reflection API, который помогает легко достичь различные области ООП-структур.

  5. Ссылки

  Также можно посмотреть пример использования Reflection API в пакете Codeception в классе Stub.
  Этот класс через рефлексию помогает мо́кать методы и свойства в unit-тестах.

  Следует добавить, что Reflection API работает довольно медленно, по этому не стоит сильно увлекаться. Использовать рекомендуется в тестах или во время отладки, но если можно обойтись без него, то лучше так и сделать. И категорически не рекомендуется использовать в рабочем коде проекта, т.к. это ещё и не безопасно.

  Источник