php-rpc-doc/README.md

47 lines
1.3 KiB
Markdown
Raw Normal View History

2018-06-06 12:50:54 +00:00
# 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-06 12:50:54 +00:00
+ 方法一composer命令 `composer require itxq/wechat-sdk-php`
+ 方法二:直接下载压缩包,然后进入项目中执行 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`查看