reflection

台風のreflection

タイフーンreflectionネイティブの PHP reflectionの代替手段です。それは次のとおりです。

• 静的 (反映されたコードを実行または自動ロードしません)、
• 高速 (遅延読み込みとキャッシュのため)、
• ネイティブreflectionと完全に互換性があり、
• Psalm および PHPStan phpDoc タイプのほとんどをサポートします。
• テンプレートを解決できます。
• メモリリークがなく、zend.enable_gc=0 で安全に使用できます。

インストール

reflection -stubs">

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

typhoon/phpstorm- reflection -stubs jetbrains/phpstorm-stubsのブリッジです。このパッケージを使用しないと、内部クラスと関数はテンプレートなしのネイティブreflectionから反映されます。

基本的な使い方

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

ドキュメント

• ネイティブreflectionアダプター
• 反射型
• PHPDoc のプロパティとメソッドの反映
• カスタムタイプの実装
• キャッシング

ドキュメントはまだ完成には程遠いです。物事がどのように機能するかを明確にするために、ためらわずに問題を作成してください。