composer自动生成接口文档的示例

这篇文章主要介绍composer自动生成接口文档的示例,文中介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们一定要看完!

海曙ssl适用于网站、小程序/APP、API接口等需要进行数据传输应用场景,ssl证书未来市场广阔!成为创新互联建站的ssl证书销售渠道,可以享受市场价格4-6折优惠!如果有意向欢迎电话联系或者加微信:18982081108(备注:SSL证书合作)期待与您的合作!

安装composer

1.先下载Composer-Setup.exe,下载地址:下载Composer 。会自动搜索PHP.exe的安装路径,如果没有,就手动找到php路径下的php.exe。

2.在PHP目录下,打开php.ini文件,开启openssl扩展。去掉extension=php_openssl.dll前面的分号(;)

3.把php目录添加到环境变量(和php.exe同级目录的路径)例如:D:\apache_php\php添加到环境变量path里。

4.下载composer.phar,下载地址:Composer.phar  将composer.phar文件放入php目录下,在php目录下新建一个文件composer.cmd,内容写成:
@php "%~dp0composer.phar" %*保存。运行这个文件,然后打开cmd运行:composer会出现
可以运行composer --version 查看composer的版本。

5.在命令行中执行:composer config -g repo.packagist composer https://packagist.phpcomposer.com

改写Packagist 镜像至国内镜像可以加快下载速度。

最后提一下,看云上有composer的中文手册http://www.kancloud.cn/thinkphp/composer

通过composer安装软件,实现自动生成接口文档(https://packagist.org/packages/weiwei/api-doc)

cmd 进入项目目录,输入composer require weiwei/api-doc。

(TP5)/application/extra/view/doc.php:

 "海泉智腾APi接口文档(ios)",  //文档title
    'version'=>'1.0.0', //文档版本
    'copyright'=>'Powered By kraus', //版权信息
    'controller' => [
        //需要生成文档的类
      'app\\ios\\controller\\Index',
      'app\\ios\\controller\\Member',
      'app\\ios\\controller\\Sms',
      'app\\ios\\controller\\Address',
      'app\\ios\\controller\\Goods',
      'app\\ios\\controller\\Cart',
      'app\\ios\\controller\\Order',
      'app\\ios\\controller\\Comment',
      'app\\admin\\controller\\GoodsNum',
    ],
    'filter_method' => [
        //过滤 不解析的方法名称
        '_empty'
    ],
    'return_format' => [
        //数据格式
        'code' => "200/205/301/307",
        'msg' => "状态码说明",
    ],
    'public_header' => [
        //全局公共头部参数
        //['name'=>'', 'require'=>1, 'default'=>'', 'desc'=>''],
        //['name'=>'', 'require'=>1, 'default'=>'', 'desc'=>''],
    ],
    'public_param' => [
        //全局公共请求参数,设置了所有的接口会自动增加次参数
        //['name'=>'token','type'=>'字符串', 'require'=>1, 'default'=>'','other'=>'用户唯一身份标识码', 'desc'=>'token'],
        ['name'=>'sign','type'=>'字符串', 'require'=>1, 'default'=>'','other'=>'接口参数加密', 'desc'=>'签名'],
    ],
];

route.php:

短信验证码发送
Route::rule('imemsg','ios/member/memsg');//获取用户信息

address.php:

URL输入:ip/doc

以上是“composer自动生成接口文档的示例”这篇文章的所有内容,感谢各位的阅读!希望分享的内容对大家有帮助,更多相关知识,欢迎关注创新互联行业资讯频道!


新闻名称:composer自动生成接口文档的示例
当前链接:http://myzitong.com/article/gdcppc.html