2018-06-06 12:50:54 +00:00
|
|
|
|
# Api-Doc-PHP
|
2018-06-06 03:09:43 +00:00
|
|
|
|
|
2018-06-07 07:22:08 +00:00
|
|
|
|
### 主要功能:
|
|
|
|
|
|
|
|
|
|
+ 根据接口注释自动生成接口文档
|
|
|
|
|
|
|
|
|
|
### 演示地址
|
|
|
|
|
|
|
|
|
|
[【Gitee Pages:】http://itxq.gitee.io/api-doc-php](http://itxq.gitee.io/api-doc-php)
|
|
|
|
|
|
2018-06-06 03:09:43 +00:00
|
|
|
|
### 开源地址:
|
|
|
|
|
|
2018-06-06 12:50:54 +00:00
|
|
|
|
[【GigHub:】https://github.com/itxq/api-doc-php](https://github.com/itxq/api-doc-php)
|
2018-06-06 03:09:43 +00:00
|
|
|
|
|
2018-06-06 12:50:54 +00:00
|
|
|
|
[【码云:】https://gitee.com/itxq/api-doc-php](https://github.com/itxq/api-doc-php)
|
2018-06-06 03:09:43 +00:00
|
|
|
|
|
|
|
|
|
### 扩展安装:
|
|
|
|
|
|
2018-06-24 04:19:11 +00:00
|
|
|
|
+ 方法一:composer命令 `composer require itxq/api-doc-php`
|
2018-06-06 12:50:54 +00:00
|
|
|
|
|
|
|
|
|
+ 方法二:直接下载压缩包,然后进入项目中执行 composer命令 `composer update` 来生成自动加载文件
|
2018-06-06 03:09:43 +00:00
|
|
|
|
|
|
|
|
|
### 引用扩展:
|
|
|
|
|
|
|
|
|
|
+ 当你的项目不支持composer自动加载时,可以使用以下方式来引用该扩展包
|
|
|
|
|
|
2018-06-06 12:50:54 +00:00
|
|
|
|
```
|
|
|
|
|
// 引入扩展(具体路径请根据你的目录结构自行修改)
|
|
|
|
|
require_once __DIR__ . '/vendor/autoload.php';
|
|
|
|
|
```
|
2018-06-06 03:09:43 +00:00
|
|
|
|
|
|
|
|
|
### 使用扩展:
|
|
|
|
|
|
|
|
|
|
```
|
2018-06-06 12:50:54 +00:00
|
|
|
|
// 引入扩展(具体路径请根据你的目录结构自行修改)
|
|
|
|
|
require_once __DIR__ . '/../vendor/autoload.php';
|
|
|
|
|
// 加载测试API类1
|
|
|
|
|
require_once __DIR__ . '/Api.php';
|
|
|
|
|
// 加载测试API类2
|
|
|
|
|
require_once __DIR__ . '/Api2.php';
|
2018-06-06 03:09:43 +00:00
|
|
|
|
$config = [
|
|
|
|
|
'class' => ['Api', 'Api2'], // 要生成文档的类
|
2018-06-06 12:50:54 +00:00
|
|
|
|
'filter_method' => ['__construct'], // 要过滤的方法名称
|
2018-06-06 03:09:43 +00:00
|
|
|
|
];
|
2018-06-07 05:56:34 +00:00
|
|
|
|
$api = new \itxq\apidoc\BootstrapApiDoc($config);
|
|
|
|
|
$doc = $api->getHtml();
|
|
|
|
|
exit($doc);
|
2018-06-06 05:41:31 +00:00
|
|
|
|
```
|
2018-06-06 12:50:54 +00:00
|
|
|
|
### 具体效果可运行test目录下的`index.php`查看
|