README.md

通过定义PHP Doc规则生成API文档

使用方法：

1. 引入本库

composer require liluoao/api-doc

2. 实例化核心类

第一个参数是需要生成文档的文件夹路径

第二个参数可选，保存生成文档的路径，默认为当前目录

$apiDoc = new \Liluoao\ApiDoc('your-file-folder');

3. 配置

包括你的文档名，和 snake_case 转换 camelCase 的配置

$apiDoc->setName('doc-name');
$apiDoc->setCamel2SnakeConfig(false, false, 0, 0);

4. 执行

$apiDoc->init();

规则:

首行为空

第二行为描述

第三行以api开头，接上请求方式和URL

参数备注中不能出现空格，建议替换成标点符号

格式示例：

/**
 * 组合一句问候
 * api GET /index/hello
 * @param string $name 你想问候的人
 * @param string $say 问候语
 * @return string 组合后的话
 */
public function hello(string $name, string $say): string {
    return "Hello,{$name},{$say}";
}