Add reflection details to context (#1782)

Author: DerManoMann

src/Analysers/AttributeAnnotationFactory.php

@@ -71,7 +71,7 @@ public function build(\Reflector $reflector, Context $context): array
                         foreach ($rp->getAttributes($attributeName, \ReflectionAttribute::IS_INSTANCEOF) as $attribute) {
                             /** @var OA\Property|OA\Parameter|OA\RequestBody $instance */
                             $instance = $attribute->newInstance();
-                            $instance->_context = new Context(['nested' => false], $context);
+                            $instance->_context = new Context(['nested' => false, 'reflector' => $rp], $context);
 
                             $type = (($rnt = $rp->getType()) && $rnt instanceof \ReflectionNamedType) ? $rnt->getName() : Generator::UNDEFINED;
                             $nullable = $rnt ? $rnt->allowsNull() : true;
@@ -89,7 +89,7 @@ public function build(\Reflector $reflector, Context $context): array
 
                                 if ($rp->isPromoted()) {
                                     // ensure each property has its own context
-                                    $instance->_context = new Context(['generated' => true, 'annotations' => [$instance]], $context);
+                                    $instance->_context = new Context(['generated' => true, 'annotations' => [$instance], 'reflector' => $rp], $context);
 
                                     // promoted parameter - docblock is available via class/property
                                     if ($comment = $rp->getDeclaringClass()->getProperty($rp->getName())->getDocComment()) {
@@ -101,7 +101,7 @@ public function build(\Reflector $reflector, Context $context): array
                                     $instance->name = $rp->getName();
                                 }
                                 $instance->required = !$nullable;
-                                $context = new Context(['nested' => $this], $context);
+                                $context = new Context(['nested' => $this, 'reflector' => $rp], $context);
                                 $context->comment = null;
                                 $instance->merge([new OA\Schema(['type' => $type, '_context' => $context])]);
                             }
@@ -115,6 +115,7 @@ public function build(\Reflector $reflector, Context $context): array
                         if ($annotation instanceof OA\Property && Generator::isDefault($annotation->type)) {
                             // pick up simple return types
                             $annotation->type = $rrt->getName();
+                            $annotation->_context->reflector = $rrt;
                         }
                     }
                 }

src/Analysers/ReflectionAnalyser.php

@@ -101,6 +101,7 @@ protected function analyzeFqdn(string $fqdn, Analysis $analysis, array $details)
             'line' => $rc->getStartLine(),
             'annotations' => [],
             'scanned' => $details,
+            'reflector' => $rc,
         ], $analysis->context);
 
         $definition = [
@@ -131,6 +132,7 @@ protected function analyzeFqdn(string $fqdn, Analysis $analysis, array $details)
                     'filename' => $method->getFileName() ?: null,
                     'line' => $method->getStartLine(),
                     'annotations' => [],
+                    'reflector' => $method,
                 ], $context);
                 foreach ($this->annotationFactories as $annotationFactory) {
                     $analysis->addAnnotations($annotationFactory->build($method, $ctx), $ctx);
@@ -144,6 +146,7 @@ protected function analyzeFqdn(string $fqdn, Analysis $analysis, array $details)
                     'property' => $property->getName(),
                     'comment' => $property->getDocComment() ?: null,
                     'annotations' => [],
+                    'reflector' => $property,
                 ], $context);
                 if ($property->isStatic()) {
                     $ctx->static = true;
@@ -170,6 +173,7 @@ protected function analyzeFqdn(string $fqdn, Analysis $analysis, array $details)
                     'constant' => $constant->getName(),
                     'comment' => $constant->getDocComment() ?: null,
                     'annotations' => [],
+                    'reflector' => $constant,
                 ], $context);
                 foreach ($annotationFactory->build($constant, $ctx) as $annotation) {
                     if ($annotation instanceof OA\Property) {

src/Context.php

@@ -30,7 +30,8 @@
  * @property array|null                   $implements
  * @property string|null                  $method
  * @property string|null                  $property
- * @property string|\ReflectionType|null  $type
+ * @property \Reflector|null              $reflector   Optional reflection details
+ * @property string|null                  $type        Optional native data type
  * @property bool|null                    $static      Indicate a static method
  * @property bool|null                    $nullable    Indicate a nullable value
  * @property bool|null                    $generated   Indicate the context was generated by a processor or