Yii2自动生成接口文档插件 yii2-doc-online

    眼下前后端完全分离的开发模式是越来越火,好多项目都直接摒弃了常规的套页面方式,而改用前端控制主要业务逻辑,后端只提供接口数据的模式。这样一来,前后端就需要频繁的沟通接口含义。于是一个好的接口文档总是能事半功倍的,但是后台开发人员开发出接口后,写接口文档又是一个麻烦的事情,费时费力不说,当接口改动时,还要时刻记着去修改接口文档。

    介于本人平时需要开发很多接口,也要写很多文档,于是决定开发一款可以自动生成接口文档的小工具——yii2-doc-online,只要开发人员按照规范写好注释,那么接口文档就会自动生成了。

    代码已经开源与github,项目地址:https://github.com/kaopur/yii2-doc-online

    效果图见

8 comments:

  1. yii2-doc-online未配置成功,’doconline’ => [
    ‘item’ => ‘frontend’,
    ‘class’ => ‘Kaopur\yii2_doc_online\Module’,
    ‘defaultRoute’ => ‘index’,
    //默认控制器
    ‘appControllers’ => true,
    //是否检测app\controllers命名空间下的控制器
    ‘suffix’ => ”,
    //api后缀
    ‘prefix’ => ”,
    //api前缀
    ‘modules’ => [ //需要生成文档的模块
    ],
    ],
    根据教程,这样并不能为frontend生成api文档,求指导

  2. 页面显示为空,是因为配置出现问题吗?
    ‘modules’ => [
    ‘doconline’ => [
    ‘class’ => ‘Kaopur\yii2_doc_online\Module’,
    ‘defaultRoute’ => ‘index’, //默认控制器
    ‘appControllers’ => true, //是否检测app\controllers命名空间下的控制器
    ‘suffix’ => ”, //api后缀
    ‘prefix’ => ”, //api前缀
    ‘modules’ => [ //需要生成文档的模块命名空间
    ‘backend\controllers\IndexController’
    ],
    ],
    ],

    1. @接碰飞:我的也是这样配置,页面显示为这人,有正确的配置吗,能发一份不

评论已关闭。