Разбор класса в PHP: от рефлексии до низкоуровневого парсинга

Расширенные примеры разбора класса

1. Рекурсивный обзор иерархии классов с Reflection

Следующий код показывает, как получить цепочку наследования, интерфейсы и трейты для любого класса.

<?php
interface Logger {}
trait Timestampable {
    public function getCreatedAt() { return new DateTime(); }
}
class BaseEntity {}
class Product extends BaseEntity implements Logger {
    use Timestampable;
    public string $name;
    protected float $price;
}

$ref = new ReflectionClass('Product');
echo 'Родительский класс: ' . ($ref->getParentClass() ? $ref->getParentClass()->getName() : 'нет') . PHP_EOL;
echo 'Интерфейсы: ' . implode(', ', $ref->getInterfaceNames()) . PHP_EOL;
echo 'Трейты: ' . implode(', ', array_keys($ref->getTraits())) . PHP_EOL;
echo 'Свойства (включая унаследованные): ';
foreach ($ref->getProperties() as $prop) {
    echo $prop->getName() . ' из класса ' . $prop->getDeclaringClass()->getName() . ', ';
}

Родительский класс: BaseEntity
Интерфейсы: Logger
Трейты: Timestampable
Свойства (включая унаследованные): name из класса Product, price из класса Product

2. Получение типов параметров методов и возвращаемых значений

ReflectionMethod позволяет анализировать сигнатуру метода, включая union types в PHP 8.

<?php
class Calculator {
    public function add(int|float $a, int|float $b): int|float {
        return $a + $b;
    }
}

$method = new ReflectionMethod('Calculator', 'add');
echo 'Параметры:' . PHP_EOL;
foreach ($method->getParameters() as $param) {
    $type = $param->getType();
    echo '  ' . $param->getName() . ': ' . $type . ' (разрешённые типы: ' . implode(', ', $type instanceof ReflectionUnionType ? $type->getTypes() : [$type]) . ')' . PHP_EOL;
}
echo 'Возвращаемый тип: ' . $method->getReturnType();

Параметры:
  a: int|float (разрешённые типы: int, float)
  b: int|float (разрешённые типы: int, float)
Возвращаемый тип: int|float

3. Создание генератора документации на основе аннотаций

Этот пример извлекает все публичные методы класса и их DocBlock комментарии, формируя HTML-список.

<?php
class UserService {
    /**
     * Получить пользователя по ID
     * @param int $id
     * @return User|null
     */
    public function find(int $id): ?User {}
    
    /**
     * Сохранить пользователя
     * @param User $user
     * @return bool
     */
    public function save(User $user): bool {}
}

$ref = new ReflectionClass('UserService');
$methods = $ref->getMethods(ReflectionMethod::IS_PUBLIC);
$docs = [];
foreach ($methods as $method) {
    $doc = $method->getDocComment();
    if ($doc) {
        $docs[$method->getName()] = $doc;
    }
}
echo '<ul>';
foreach ($docs as $name => $doc) {
    echo '<li><strong>' . htmlspecialchars($name) . '</strong>: ' . nl2br(htmlspecialchars($doc)) . '</li>';
}
echo '</ul>';

<ul><li><strong>find</strong>: /**
     * Получить пользователя по ID
     * @param int $id
     * @return User|null
     */</li><li><strong>save</strong>: /**
     * Сохранить пользователя
     * @param User $user
     * @return bool
     */</li></ul>

4. Динамическая проверка атрибутов (PHP 8) для маршрутизации

Атрибуты - современный способ метапрограммирования. Reflection позволяет их обрабатывать.

<?php
#[Attribute]
class Route {
    public function __construct(public string $path) {}
}

#[Route('/api/users')]
class UserApiController {}

$ref = new ReflectionClass('UserApiController');
$routeAttr = $ref->getAttributes(Route::class)[0] ?? null;
if ($routeAttr) {
    $route = $routeAttr->newInstance();
    echo 'Path: ' . $route->path;
}

Path: /api/users

5. Копирование свойств между объектами с помощью ReflectionProperty

ReflectionProperty позволяет устанавливать и получать значения даже приватных свойств внутри или вне класса (с setAccessible).

<?php
class Order {
    private int $id;
    public string $status;
    
    public function __construct(int $id, string $status) {
        $this->id = $id;
        $this->status = $status;
    }
}

$order1 = new Order(1, 'new');
$order2 = new Order(2, 'paid');

$ref = new ReflectionClass('Order');
foreach ($ref->getProperties() as $prop) {
    $prop->setAccessible(true);
    $value = $prop->getValue($order1);
    $prop->setValue($order2, $value);
}
echo 'id: ' . $ref->getProperty('id')->getValue($order2) . ', status: ' . $order2->status;

id: 1, status: new