README

ThinkPHP5 swagger Swagger composer 模块

安装

一、执行命令安装

composer require westhack/think-swagger

或者

二、通过 require 安装

"require": {
        "westhack/think-swagger":"*"
},

或者

三、按照 psr-4 标准进行 autoload 安装

1. 进入 vendor/westhack 目录（如果没有 westhack 目录，请 mkdir westhack）
2. git clone
3. 将 git clone 下来的项目名称修改为 think-swagger
4. 添加以下配置

    "autoload": {
           "psr-4": {
               "westhack\\swagger\\": "vendor/westhack/think-swagger/src"
           },
           "files": [
               "vendor/westhack/think-swagger/src/route.php"
           ]
       },

1. php composer.phar update

使用

添加配置文件

1. 默认配置在 config 下的 swagger.php
2. 需要自定义配置，请将 config 下的 swagger.php 复制到 extra 目录下（或者通过以下 console 添加配置文件）

使用方法

初始化项目资源

在项目目录下找到 command.php，添加控制台配置以下内容

    return [
        'westhack\swagger\SwaggerAssetRegister'
    ];
  

执行 console 命令初始化 assets 资源

    php think swaggerAssetRegister   ## 默认资源目录
    php think swaggerAssetRegister --path /public/static   ## 绝对路径
    php think swaggerAssetRegister --path swagger/ui   ## 默认资源目录下面的路径
  

执行 console 命令初始化 config 配置

    php think swaggerAssetRegister --config y   ## 初始化 config 配置

访问

    http://你的域名/index.php?s=swagger ## swagger ui
    http://你的域名/index.php?s=swagger/api ##  swagger json
    http://你的域名/index.php?s=swagger/api&clear-cache ## 清除缓存（如果开启缓存）

在 php 文件中添加注释

/**
 * @SWG\Info(title="My First API", version="0.1")
 */

/**
 * @SWG\Get(
 *     path="/api/resource.json",
 *     @SWG\Response(response="200", description="An example resource")
 * )
 */