php - Swagger-php 如何排除整个 /vendor 文件夹但附加一个带有共享模型的子文件夹

Question

我正在使用的包是Swagger-php

我目前通过执行生成招摇文件：

./vendor/bin/openapi --output storage/app/swagger/swagger.json --exclude tests --exclude storage --exclude vendor ./

而且我有一些模型在多个 api 之间共享，所以我希望 swagger 模式定义与这些模型一起使用

./vendor/utilities/php-general-tools/src/models/

所以我需要包括那个文件夹，但它目前被排除在外.. 显示的错误是

$ref "#/components/schemas/" not found for @OA\JsonContent() in ...

Answer 1

我能够解决这个问题..所以显然你可以添加多个路径作为最后一个参数，用空格分隔，比如

./vendor/bin/openapi --output storage/app/swagger/swagger.json --exclude vendor --exclude tests --exclude storage ./ ./vendor/utilities/php-general-tools/src/models/

所以两者都./将./vendor/utilities/php-general-tools/src/models/被扫描以获取注释