tp6 如何使用 swagger

在 ThinkPHP 6 中，你可以使用 `topthink/think-swagger` 扩展来集成 Swagger。

下面是使用 Swagger 的步骤：

1. 安装扩展：

   composer require topthink/think-swagger

2. 配置扩展：
在 `config/swagger.php` 文件中配置 Swagger 扩展的相关信息。你可以设置文档的标题、描述、版本等信息，还可以指定控制器和路由规则。

3. 编写注解：
在控制器的方法上使用 Swagger 注解来描述接口的参数、返回值等信息。例如：

   /**
    * @title 获取用户信息
    * @description 根据用户ID获取用户信息
    * @header name:Authorization require:1 default:Bearer xxx
    * @param int $id 用户ID
    * @return \think\Response
    * @throws \think\Exception
    */
   public function getUserInfo($id)
   {
       // 方法逻辑
   }

4. 生成文档：
运行以下命令来生成 Swagger 文档：

   php think swagger:generate

5. 访问文档：
启动项目后，访问 `/swagger/index.html` 即可查看生成的 Swagger 文档。

通过以上步骤，你就可以在 ThinkPHP 6 中使用 Swagger 来生成接口文档了。记得根据实际情况进行相应的配置和注解。