1 Star 1 Fork 0

WangxianTech / yii2-api-doc

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
该仓库未声明开源许可证文件(LICENSE),使用请关注具体项目描述及其代码上游依赖。
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README

Yii2 Annotations Generate API Document Extension


Latest Stable Version Total Downloads Latest Unstable Version License Suggesters Dependents

yii2-api-doc

通过对yii2的代码注释方便地生成在线api文档

安装

安装此扩展的首选方式是通过 composer.

或者运行

composer require --prefer-dist zhuzixian520/yii2-api-doc "*"

或者添加

"zhuzixian520/yii2-api-doc": "*"

到你的composer.json文件中的 require 的部分,然后运行

composer install

用法

一旦扩展安装,只需在您的代码中这样使用它:

return [
    'modules' => [
        'api_doc' => [
            'class' => 'zhuzixian520\api_doc\Module',
            'hostApiDev' => 'http://api-dev.demo.com',//开发环境接口主机地址
            'hostApiProd' => 'http://api.demo.com',//生产环境接口主机地址
            'hostApiTest' => 'http://api-test.demo.com',//测试环境接口主机地址
            'author' => 'Trevor',
            'email' => 'service@wangxiankeji.com',
            'logo_src' => '/img/logo_64_64.png',//web目录下
            'icp_num' => '粤ICP备15025495号',
            'copyright_website' => 'http://www.sijiche.com',
            'company_start_year' => '2015',
        ],
        'v1' => [
            'class' => 'api\modules\v1\V1Module',
        ],
    ],
];

接口中控制器代码注释

class PassportController extends yii\rest\Controller
{
    /**
     * 微信PC网页登录
     * @method POST
     * @token 0
     * @param string code 同意授权后的code 是
     * @res string token 访问令牌
     * @return array
     */
    public function actionLoginByWechatPc(): array {}
}

输出结果

img.png

img_1.png

访问接口文档地址

类似gii与debug,你也可以修改参数V,来切换接口版本

http://yourhost/api_doc?v=1

联系作者

邮箱:zhuzixian520@126.com

空文件

简介

Generate online api document by code annotation for yii2 easily 展开 收起
取消

贡献者

全部

近期动态

加载更多
不能加载更多了
马建仓 AI 助手
尝试更多
代码解读
代码找茬
代码优化
PHP
1
https://gitee.com/wangxian-tech/yii2-api-doc.git
git@gitee.com:wangxian-tech/yii2-api-doc.git
wangxian-tech
yii2-api-doc
yii2-api-doc
master

搜索帮助

344bd9b3 5694891 D2dac590 5694891