Быстрый поиск файла класса и метода через Reflection API в PHP

Зачем это в работе с 1С‑Битрикс

В большом проекте классы разбросаны по /local/php_interface/, модулям, составным автозагрузкам и vendor. Когда нужно понять, откуда берётся поведение компонента, сервиса или ORM‑сущности, первый шаг — хотя бы знать файл объявления. Reflection API встроен в PHP и не требует grep по всему диску: достаточно строки с полным именем класса и имени метода.

Файл, в котором объявлен класс

ReflectionClass принимает имя класса в том виде, в каком его видит автозагрузчик: с ведущим обратным слэшем для глобального пространства имён или без него для классов в текущем namespace. Метод getFileName() возвращает абсолютный путь к файлу определения или false для встроенных и части специальных случаев.

$mirror = new \ReflectionClass(\Vendor\Package\OfferMapper::class);
$declarationPath = $mirror->getFileName();
// Например CLI-скрипт: fwrite(STDERR, $declarationPath . PHP_EOL);

Для отладки через веб лучше не печатать путь в публичный вывод боевого сайта — используйте лог на копии проекта или одноразовый скрипт в CLI.

Файл конкретного метода

У метода путь к файлу может отличаться от файла класса, если тело взято из трейта: ReflectionMethod::getFileName() указывает на место фактического объявления. Ниже — минимальный разбор метода экземпляра по строковому имени класса из переменной.

$fqcn = '\Acme\Catalog\PriceTable';
$mirror = new \ReflectionClass($fqcn);
$hook = $mirror->getMethod('recalculate');
$path = $hook->getFileName();
var_export($path);

Для статического вызова имени метода достаточно того же getMethod. Если нужно найти произвольную функцию вне класса, используйте ReflectionFunction по строковому имени функции.

Ограничения, о которых стоит помнить

• Кеш и среда: Reflection показывает структуру так, как её видит текущий процесс PHP; при сомнениях отключите кеш на тестовой среде или сравните с исходниками после деплоя.
• Динамический код: классы, собранные через eval или генерацию без файла, могут не иметь обычного пути — разбирайте такие места аккуратно.
• Наследование: для метода подкласса вы смотрите конкретный класс, переданный в ReflectionClass; при необходимости обходите цепочку родителей через getParentClass().

Кратко

• ReflectionClass::getFileName() — файл объявления класса.
• ReflectionMethod::getFileName() — файл, где лежит реализация метода (в т. ч. из трейта).
• Используйте полное имя с namespace; проверку делайте на копии сайта.