Sobre el proyecto
TypeResolver y FqsenResolver es una biblioteca PHP de phpDocumentor que implementa la especificación PSR-5 para tipos en DocBlocks. Proporciona dos resolutores: uno que convierte expresiones de tipo en objetos de valor, y otro que resuelve nombres parciales de elementos estructurales en nombres de elementos estructurales totalmente cualificados (FQSEN).
Qué maneja el TypeResolver:
- Primitivos de PHP y pseudoprimitivos como string o void (`@var string`, `@return void`)
- Tipos compuestos como arrays de un tipo (`@var string[]`)
- Tipos compuestos como uniones (`@var string|integer`)
- Expresiones de array (`@var (string|TypeResolver)[]`)
- Objetos e interfaces, incluidos los tipos nullable introducidos en PHP 7.1, que se envuelven en un objeto Nullable
Qué maneja el FqsenResolver:
- Expresiones de constantes, funciones, clases, interfaces y traits
- Constantes de clase, propiedades y métodos (p. ej. `\MyNamespace\MyClass::myMethod()`)
Una capacidad clave es expandir nombres parciales de clases y elementos a nombres totalmente cualificados. Para ello, los resolutores aceptan un objeto Context que lleva el espacio de nombres actual y cualquier alias/importación de espacio de nombres. Los Context se pueden crear manualmente, o mediante ContextFactory a partir de un reflector o de un espacio de nombres más el código fuente del archivo.
La instalación se realiza mediante Composer: `composer require phpdocumentor/type-resolver`. El README incluye ejemplos ejecutables y señala una carpeta de ejemplos. El proyecto tiene licencia MIT y utiliza insignias de QA, Coveralls y Scrutinizer para el estado de compilación, la cobertura y la calidad del código.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.