Placing annotations in external files

[BigBlockStudios]

• L5-Swagger Version: 8.6.1
• PHP Version: 8.2.22
• OS: Ubuntu

Description:

Annotations placed in external files not read.
I would like to place annotations in external files beside the class/models/resources/etc. Creating a User.php model/class and an annotation file beside it UserAnnotation.php with just the annotation in it is ignored. No errors are thrown.
It appears that only php files with annotations are scanned if there is a matching class or method declaration.

Steps To Reproduce:

Create a file with class Foo.php
Create a file FooAnnotation.php containing only the annotation block.

[DerManoMann]

Correct. The annotations need a class, interface or class-like. Those can be empty dummy classes.
https://zircote.github.io/swagger-php/guide/faq.html#warning-required-oa-info-not-found

[BigBlockStudios]

Thanks - I did find and read that little bit and wondered if your package was doing something different ... I did try the dummy class several times but the annotations were not getting picked up.

What did finally work was adding the namespace to the dummy class...

`<?php

namespace App\Models;

/**

• @OA\Schema(

• schema="Project",
  

• type="object",
  

• required={"title", "creator_id"},
  

• @OA\Property(
  

•     property="id",
  

•     type="integer",
  

•     example=1
  

• ),
  

• @OA\Property(
  

•     property="title",
  

•     type="string",
  

•     example="Project Title"
  

• )
  

• )
  */
  class ProjectAnnotation
  {

}`

should have been obvious I suppose.

[DerManoMann]

Correct. For reflection to work the classes need to be Auto loadable and that requires correct namespaces.