عن المشروع

TypeResolver وFqsenResolver هي مكتبة PHP من phpDocumentor تنفذ مواصفة PSR-5 للأنواع في DocBlocks. توفر محللين اثنين: أحدهما يحول تعبيرات الأنواع إلى كائنات قيمية، والآخر يحل أسماء العناصر الهيكلية الجزئية إلى أسماء عناصر هيكلية مؤهلة بالكامل (FQSEN). ما يتعامل معه TypeResolver: - الأنواع الأولية والأنواع الأولية الزائفة في PHP مثل string أو void (`@var string`، `@return void`) - الأنواع المركبة مثل مصفوفات من نوع (`@var string[]`) - الأنواع المركبة مثل الاتحادات (`@var string|integer`) - تعبيرات المصفوفات (`@var (string|TypeResolver)[]`) - الكائنات والواجهات، بما في ذلك الأنواع القابلة للقيمة الفارغة التي أُدخلت في PHP 7.1، والتي تُغلَّف في كائن Nullable ما يتعامل معه FqsenResolver: - تعبيرات الثوابت والدوال والفئات والواجهات والسمات - ثوابت الفئات والخصائص والدوال (مثل `\MyNamespace\MyClass::myMethod()`) من القدرات الأساسية توسيع أسماء الفئات والعناصر الجزئية إلى أسماء مؤهلة بالكامل. ولتحقيق ذلك، يقبل المحللان كائن Context يحمل مساحة الأسماء الحالية وأي أسماء مستعارة أو استيرادات لمساحات الأسماء. يمكن إنشاء كائنات Context يدويًا، أو عبر ContextFactory من reflector أو من مساحة أسماء مع شفرة مصدرية لملف. يتم التثبيت عبر Composer: `composer require phpdocumentor/type-resolver`. يتضمن README أمثلة قابلة للتشغيل ويشير إلى مجلد أمثلة. المشروع مرخص بموجب MIT ويستخدم شارات QA وCoveralls وScrutinizer لحالة البناء والتغطية وجودة الشفرة.