reflection

reflection do tufão

reflection do Typhoon é uma alternativa à reflection nativa do PHP. Isso é:

• estático (não executa nem carrega automaticamente o código refletido),
• rápido (devido ao carregamento e cache lentos),
• totalmente compatível com reflection nativa,
• suporta a maioria dos tipos phpDoc Psalm e PHPStan,
• pode resolver modelos,
• não vaza memória e pode ser usado com segurança com zend.enable_gc=0.

Instalação

reflection -stubs">

 composer require typhoon/ reflection typhoon/phpstorm- reflection -stubs

typhoon/phpstorm- reflection -stubs é uma ponte para jetbrains/phpstorm-stubs . Sem este pacote, as classes e funções internas são refletidas a partir da reflection nativa sem modelos.

Uso Básico

reflectionTyphoonReflector; use TyphoonTypetypes; use function TyphoonTypestringify; /** * @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'>"">

 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'>" 

Documentação

• Adaptadores reflection nativos
• Tipos refletivos
• Refletindo propriedades e métodos do PHPDoc
• Implementando tipos personalizados
• Cache

A documentação ainda está longe de estar completa. Não hesite em criar questões para esclarecer como as coisas funcionam.