symfony - NelmioApiDocBundle 不起作用“规范中没有定义操作！”

Question

我想将 nelmio 用于 symfony-project，但它不起作用。

它总是说：规范中没有定义任何操作！

我还尝试了https://symfony.com/doc/current/bundles/NelmioApiDocBundle/index.html上的示例

怎么了？有任何想法吗？

路由.yml

app.swagger_ui:
    path: /api/doc
    methods: GET
    defaults: { _controller: nelmio_api_doc.controller.swagger_ui }

配置.yml

nelmio_api_doc:
    areas:
        path_patterns: # an array of regexps
        - ^/api(?!/doc$)
        host_patterns:
        - ^api\.

控制器

/**
 * @Route("/api/test", methods={"GET"})
 * @SWG\Response(
 *     response=200,
 *     description="Returns the rewards of an user"
 * )
 * @SWG\Parameter(
 *     name="order",
 *     in="query",
 *     type="string",
 *     description="The field used to order rewards"
 * )
 */
public function testAction()
{

}   

作曲家.json

"symfony/symfony": "3.4.*",
"nelmio/api-doc-bundle": "3.2.1",

Answer 1

如果任何命令事件（通常是 post-install-cmd 或 post-update-cmd）触发 ScriptHandler::installAssets 脚本，则资产通常由 composer 安装。如果你还没有设置这个脚本，你可以手动执行这个命令：

php bin/控制台资产：安装 --symlink

Answer 2

只需删除

host_patterns:
    - ^api\.

并将您的虚拟主机设置为

documentation:
  host: symfony.localhost

Answer 3

问题出在 config.yml 路径模式中。如果您删除配置（所有 nelmio_api_doc）或更改路径模式将起作用。例子：

nelmio_api_doc:
    areas:
        default:
            path_patterns: [ /api/ ]