reflection

reflection del tifón

reflection Typhoon es una alternativa a reflection PHP nativa. Es:

• estático (no ejecuta ni carga automáticamente el código reflejado),
• rápido (debido a la carga diferida y al almacenamiento en caché),
• totalmente compatible con reflection nativo,
• admite la mayoría de los tipos de phpDoc Psalm y PHPStan,
• puede resolver plantillas,
• no pierde memoria y se puede utilizar de forma segura con zend.enable_gc=0.

Instalación

reflection -stubs">

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

typhoon/phpstorm- reflection -stubs es un puente para jetbrains/phpstorm-stubs . Sin este paquete, las clases y funciones internas se reflejan a partir de reflection nativa sin plantillas.

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

Documentación

• Adaptadores reflection nativos
• Tipos reflectantes
• Reflejando propiedades y métodos de PHPDoc
• Implementación de tipos personalizados
• Almacenamiento en caché

La documentación aún está lejos de estar completa. No dude en crear problemas para aclarar cómo funcionan las cosas.