Swagger PHP and Doctrine Annotation issue

Question

I am implementing Swagger-PHP for an API we've built.

Here is a brief recap:

Language: PHP5.3

Framework: FuelPHP 1.5.3

Environment: Local (served with Nginx)

Now I have an API method defined as follow:

/**
 * @SWG\Api(
 *   path="/site/list",
 *   description="Get sites list",
 *   @SWG\Operation(...,
 *      @SWG\Parameter(...),
 *      @SWG\ResponseMessage(...),
 *      @SWG\ResponseMessage(...)
 *   )
 * )
 */
public function action_run()
{
    //doing stuff
}

I now try the following (from elsewhere in my application) to generate the JSON:

$swagger = new Swagger\Swagger('my/root/dir');
$swagger->getResource('/site/list', array('output' => 'json'));

And that first line here (when instanciating my Swagger class) is throwing me an error:

ErrorException [ User Warning ]: [Semantical Error] The class "package" is not annotated with @Annotation. Are you sure this class can be used as annotation? If so, then you need to add @Annotation to the class doc comment of "package". If it is indeed no annotation, then you need to add @IgnoreAnnotation("package") to the class doc comment of class @Swagger\Annotations\Api.

Adding the @IgnoreAnnotation("package") is actually not helping.

I notice the error disappears if I remove the @package from here:

https://github.com/zircote/swagger-php/blob/master/library/Swagger/Annotations/Api.php#L28

But that's not a solution.

I'm guessing this is mainly Doctrine-related but I can't seem to figure it out.

Thanks for any tips or ideas on that matter.

Bob Fanger · Accepted Answer · 2016-06-17 07:53:38Z

1

Because FuelPHP has a Package class (in fuel/core/package.php), which isn’t an @Annotation the DocParser generates this warning.

Swagger-PHP uses the $docParser->setIgnoreNotImportedAnnotations(true) setting, which should prevent warnings like these.

I've reported the issue and fixed the problem but sadly the patch was rejected
Report the issue (again) to doctrine, the more people complain the faster it gets fixed 😉

As a workaround replace your DocParser.php with this version

edited Jun 17, 2016 at 7:53

answered Feb 16, 2014 at 13:52

Bob Fanger

30k7 gold badges68 silver badges83 bronze badges

Sign up to request clarification or add additional context in comments.

2 Comments

peedee Over a year ago

Two years later, the original class has evolved a bit compared to this fork linked in this answer. Be careful when using his fork.

Bob Fanger Over a year ago

I was too optimistic, expecting my 1 line change to be merged. I've updated the fork and re-aplied the patch.

Collectives™ on Stack Overflow

Swagger PHP and Doctrine Annotation issue

1 Answer 1

2 Comments

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

1 Answer 1

2 Comments

Your Answer

Sign up or log in

Post as a guest

Related