TP框架中的API文檔自動生成

在ThinkPHP（簡稱TP）框架中，API文檔的自動生成可以通過以下幾種方法實現：

1. 使用Swagger-PHP： Swagger-PHP是一個用于生成API文檔的庫。要在TP框架中使用它，請按照以下步驟操作：

首先，通過Composer安裝Swagger-PHP：

composer require zircote/swagger-php

然后，在項目中創建一個Swagger配置文件（例如：swagger.php），并添加以下內容：

<?php
use Zircote\Swagger\Swagger;

return new Swagger([
    'info' => [
        'version' => '1.0.0',
        'title' => 'ThinkPHP API Documentation',
        'description' => 'API documentation for ThinkPHP framework',
        'termsOfService' => 'http://www.example.com/terms/',
        'contact' => [
            'name' => 'Your Name',
            'email' => 'your.email@example.com',
            'url' => 'http://www.example.com',
        ],
        'license' => [
            'name' => 'Apache 2.0',
            'url' => 'http://www.apache.org/licenses/LICENSE-2.0',
        ],
    ],
]);

接下來，為API添加注釋。在每個控制器和方法上添加Swagger注釋，例如：

/**
 * @OA\Get(
 *   path="/api/users",
 *   summary="Get list of users",
 *   @OA\Response(
 *     response=200,
 *     description="Success",
 *     @OA\Schema(type="array", @OA\Items(ref="#/definitions/User"))
 *   ),
 *   @OA\Response(
 *     response=400,
 *     description="Bad Request"
 *   )
 * )
 */

最后，使用Swagger生成API文檔。在項目根目錄下運行以下命令：

php think swagger:generate

這將在public目錄下生成一個名為swagger.json的文件，你可以使用Swagger UI或其他工具查看和測試API。

2. 使用ApiDoc： ApiDoc是一個用于自動生成API文檔的工具。要在TP框架中使用它，請按照以下步驟操作：

首先，通過npm全局安裝ApiDoc：

npm install apidoc -g

然后，在項目根目錄下創建一個ApiDoc配置文件（例如：apidoc.json），并添加以下內容：

{
  "name": "ThinkPHP API Documentation",
  "version": "1.0.0",
  "description": "API documentation for ThinkPHP framework",
  "title": "ThinkPHP API Docs",
  "url": "http://www.example.com",
  "footer": "Copyright ? 2021 Your Name",
  "templates": {
    "lang": "en"
  },
  "parse": {
    "require": ["path/to/your/controllers/*.php"]
  },
  "include": ["src/**/*.php"]
}

接下來，為API添加注釋。在每個控制器和方法上添加ApiDoc注釋，例如：

/**
 * @api {get} /api/users Get list of users
 * @apiGroup User
 * @apiVersion 1.0.0
 * @apiSuccessExample {json} Success-Response:
 *     HTTP/1.1 200 OK
 *     [
 *       {
 *         "id": 1,
 *         "name": "John Doe"
 *       }
 *     ]
 * @apiError Example
 *     HTTP/1.1 400 Bad Request
 *     {
 *       "error": "Invalid parameter"
 *     }
 */

最后，使用ApiDoc生成API文檔。在項目根目錄下運行以下命令：

apidoc -i src/ -o public/

這將在public目錄下生成一個名為index.html的文件，你可以直接查看API文檔。

以上就是在ThinkPHP框架中自動生成API文檔的兩種方法。你可以根據自己的需求選擇合適的工具。