typhoon / reflection
Static PHP reflection with phpDoc support
Fund package maintenance!
www.tinkoff.ru/cf/5MqZQas2dk7
Installs: 4 050
Dependents: 4
Suggesters: 0
Security: 0
Stars: 33
Watchers: 4
Forks: 3
Open Issues: 1
Requires
- php: ^8.1
- ext-tokenizer: *
- nikic/php-parser: ^4.18 || ^5.0
- phpstan/phpdoc-parser: ^1.21
- psr/simple-cache: ^3.0
- symfony/deprecation-contracts: ^3.0
- typhoon/change-detector: ^0.4.4
- typhoon/declaration-id: ^0.4
- typhoon/type: ^0.4.4
- typhoon/typed-map: ^0.4
Conflicts
README
Typhoon Reflection is an alternative to native PHP Reflection. It is:
- static (does not run or autoload reflected code),
- fast (due to lazy loading and caching),
- fully compatible with native reflection,
- supports most of the Psalm and PHPStan phpDoc types,
- can resolve templates,
- does not leak memory and can be safely used with zend.enable_gc=0.
Installation
composer require typhoon/reflection typhoon/phpstorm-reflection-stubs
typhoon/phpstorm-reflection-stubs
is a bridge for jetbrains/phpstorm-stubs
. Without this package internal classes
and functions are reflected from native reflection without templates.
Basic Usage
use Typhoon\Reflection\TyphoonReflector; use Typhoon\Type\types; use function Typhoon\Type\stringify; /** * @template TTag of non-empty-string */ final readonly class Article { /** * @param list<TTag> $tags */ public function __construct( private array $tags, ) {} } $reflector = TyphoonReflector::build(); $class = $reflector->reflectClass(Article::class); $tagsType = $class->properties()['tags']->type(); var_dump(stringify($tagsType)); // "list<TTag#Article>" $templateResolver = $class->createTemplateResolver([ types::union( types::string('PHP'), types::string('Architecture'), ), ]); var_dump(stringify($tagsType->accept($templateResolver))); // "list<'PHP'|'Architecture'>"
Documentation
- Native reflection adapters
- Reflecting Types
- Reflecting PHPDoc properties and methods
- Implementing custom types
- Caching
Documentation is still far from being complete. Don't hesitate to create issues to clarify how things work.