起:报错等
Required @OA\Info() not found
Required @OA\PathItem() not found
原因:扫描目录中的类方法未进行对应格式的注释。至少要出现一次上面的注释
新手使用,看相关 的资料不多 记录一下
安装
在thinkphp对应根目录
composer require zircote/swagger-php
文档生成
通过访问对应控制器方法来生成或使用命令行生成
public function doc(){
$openapi = \OpenApi\scan(realpath("../")."/app/wx/controller");//生成文档的扫描路径
header('Content-Type: application/json');
echo $openapi->toJson();//也可以有其他格式的输出
}
或命令行生成
./vendor/bin/openapi path/to/scan -o path/out/api.json
这里如果报错
Required @OA\Info() not found
Required @OA\PathItem() not found
原因:扫描目录中的类方法未进行对应格式的注释。非常重要,如果还是报错建议扫描目录内创建一个OpenAPI.php。 其内容如下
类似这样的