ThinkPHP5工程使用swagger写接口文档

操作步骤如下：

1. 安装最新版本composer
curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer
chmod +x /usr/local/bin/composer

2. composer更换阿里源
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

3. 安装swagger-php，建议全局安装
composer global require zircote/swagger-php
ll -n ~/.config/composer/vendor/bin/openapi /usr/local/bin/openapi

4. 在项目public目录中加入swagger-ui的内容，ho_sample_tp5项目public目录中已经包含，如果public目录中已含有项目需要的文件，可以为swagger-ui创建子目录

5. 修改swagger-ui中json文件的加载地址，在项目根目录下
vim public/index.html 找到类似如下的内容：
#    window.onload = function() {
#      // Begin Swagger UI call region
#      const ui = SwaggerUIBundle({
#        url: "https://dev0.mydomain.com/ho_sample_tp5/public/api.json",
#        dom_id: '#swagger-ui',
#        deepLinking: true,
修改其中url的内容，设置为本项目接口json文件的实际访问地址

6. 在项目中按要求加入文档注释。

7. 执行命令，生成swagger接口json文档
openapi -o JSON_FILE_PATH PROJECT_PATH
其中JSON_FILE_PATH为步骤5中指定的文件地址，PROJECT_PATH为项目地址

8. 浏览器打开http://host/PROJECT_NAME/public，查看swagger文档，例如 https://dev0.mydomain.com/ho_sample_tp5/public