Explicitly indicate version of required nelmio/api-doc-bundle

[gam6itko]

By default composer installs v3 and this error occurs:

An exception has been thrown during the rendering of a template ("[Semantical Error] The annotation "@nelmio\ApiDocBundle\Annotation\ApiDoc" in method Sonata\NewsBundle\Controller\Api\PostController::getPostsAction() does not exist, or could not be auto-loaded in Sonata\NewsBundle\Controller\Api\PostController (which is being imported from "/www/config/routes/routes.yaml").").

[core23]

Instead of locking the docs to a specific version, you could add a conflict to the composer.json file. So the docs are always valid, regardless which minor/major version we need.

[gam6itko]

You mean something like this?

"conflict": {
    "doctrine/dbal": "<2.6.0",
    "friendsofsymfony/rest-bundle": "<1.8 || >=3.0",
    "jms/serializer": "<0.13",
    "sonata-project/block-bundle": "<3.18",
    "sonata-project/doctrine-orm-admin-bundle": "<3.0 || >=4.0",
    "sonata-project/notification-bundle": "<3.0 || >=4.0",
    "sonata-project/seo-bundle": "<2.0 || >=3.0",
    "nelmio/api-doc-bundle": "<2.0 || >=3.0"
},

[core23]

Exactly 👍