composer自动生成接口文档

不言

Lepaskan： 2023-03-23 10:46:02

asal

1752 orang telah melayarinya

本篇文章介绍的内容是composer自动生成接口文档，现在分享给大家，有需要的朋友可以参考一下

安装composer(https://blog.csdn.net/sanbingyutuoniao123/article/details/70314651)
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。

route.php:

use think/Route;

Route::pattern('id','\d+');
Route::pattern('name','\w+');

Route::rule('createSign','ios/member/createSign');//生成token接口
Route::rule('iToken','ios/member/createToken');//生成token接口
Route::rule('iSendSms','ios/sms/send');//短信验证码发送
Route::rule('imemsg','ios/member/memsg');//获取用户信息

address.php:
...
/**
* @title 首页分类商品
* @description 首页分类商品
* @author tiny
* @url /itypeGoods
* @method POST
*
* @param name:tid type:int require:1 default: other: desc:商品类型id
*
* @return type:类型@
* @type id:类型id cat_name:类型名
*
* @return recommend:推荐@
* @recommend id:商品id image:商品图片 goods_name:商品名 goods_price:价格
*
* @return new:新品上市@
* @new id:商品id image:商品图片 goods_name:商品名 goods_price:价格
*
* @return image:图片@
* @image