Analyse parent classes while scanning annotations about swagger-php HOT 5 CLOSED

Swagger-php is only able to pick up on inheritance if the doc-block with the @swg\Model is directly above the "class X extends Y" line.

from swagger-php.

That sounded promising (there is nothing about that anywhere in the documentation I think). But when I tried it didn't work:

/**
 * @SWG\Model(id="User") */
class User extends Person
{

This changes nothing in the JSON.

from swagger-php.

Now I debugged the parser and it turns out that the Model ID of Swagger and the class name have to be identical – which only appears to be the case in the example I posted up there, because that example is fake and has nothing to do with my code…

It seems like I have to restructure my Model ID system, which I don't really like to do because there is a sense in having names differing from each other (there are mulitple model classes with the same name in different namespaces but they represent different Swagger Models, so I needed to add a suffix to the name).

I don't think Swagger supports something like namespacing for Model IDs. Is there a way to have the Annotations Parser map the name of the extended class to the name of the Swagger Model ID?

from swagger-php.

I've upgraded the inheritance logic to use the fully qualified classnames instead of the model->ids.

there is nothing about that anywhere in the documentation I think

Contributions to the docs are highly appreciated.
Which are located in the gh-branch: https://github.com/zircote/swagger-php/tree/gh-pages/docs

from swagger-php.

Okay, thanks for adding this functionality!

from swagger-php.