Parser Reflection API library provides a set of classes that extend original internal Reflection classes, but powered by PHP-Parser library thus allowing to create a reflection instance without loading classes into the memory.
This library can be used for analysing the source code for PHP versions 5.5, 5.6, 7.0; for automatic proxy creation and much more.
Library can be installed with composer. Installation is quite easy:
$ composer require goaop/parser-reflectionComposer will install the library to your project's vendor/goaop/parser-reflection directory.
Just use Go\ParserReflection package reflection classes like traditional ones:
$parsedClass = new \Go\ParserReflection\ReflectionClass(SomeClass::class);
var_dump($parsedClass->getMethods());Or you can use an additional classes ReflectionFile and ReflectionFileNamespace to analyse a raw PHP files
$parsedFile = new \Go\ParserReflection\ReflectionFile('SomeClass.php');
$fileNameSpaces = $parsedFile->getFileNamespaces()
var_dump($fileNameSpaces);
var_dump($fileNameSpaces[0]->getClass(SomeClass::class)->getMethods();To understand how library works let's look at what happens during the call to the new \Go\ParserReflection\ReflectionClass(SomeClass::class)
\Go\ParserReflection\ReflectionClassasks reflection engine to give an AST node for the given class name- Reflection engine asks a locator to locate a filename for the given class
ComposerLocatorinstance asks the Composer to find a filename for the given class and returns this result back to the reflection engine- Reflection engine loads the content of file and passes it to the PHP-Parser for tokenization and processing
- PHP-Parser returns an AST (Abstract Syntax Tree)
- Reflection engine then analyse this AST to extract specific nodes an wrap them into corresponding reflection classes.
All parser reflection classes extend PHP internal reflection classes, this means that you can use \Go\ParserReflection\ReflectionClass instance in any place that asks for \ReflectionClass instance. All reflection methods should be compatible with original ones, providing an except methods that requires object manipulation, such as invoke(), invokeArgs(), setAccessible(), etc. These methods will trigger the autoloading of class and switching to the internal reflection.