將@SWG \\ Definition放在哪里，以便與Swagger-PHP和Nelmio API-DOC捆綁包一起重用

Question

我想在某處編寫一個@SWG \\ Definition，並在我的Symfony 3應用程序中的多個REST API動作的@SWG \\ Response批注的@SWG \\ Schema中引用它。 我正在使用Nelmio的api-doc-bundle的dev-master版本，但似乎可以找到暗示該定義應該去哪里的任何內容。 Swagger-PHP文檔敦促盡可能避免重復，我希望遵循該建議。 有什么提示嗎？

Answer 1

典型...最后分解，然后在不久后提出解決方案...

我發現可以將文檔數據預加載到Symfony的app / config / config.yml中。

nelmio_api_doc:
    documentation:
        definitios:
            Error: 
                type: object
                properties:
                    success:
                        type: boolean
                        example: false
                    error:
                        type: string
                        example: message

現在，我可以在所有REST操作中使用類似的內容

/**
 *  @API\Operation(
 *     ...
 *     @SWG\Response(
 *         response="default",
 *         description="Failure",
 *         @SWG\Schema(ref="#definitions/Error")
 *     )
 * )
 */