thinkphp6 Swagger|OpenAPI

起：报错等

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。 其内容如下

类似这样的