- 引入本库
composer require liluoao/api-doc
- 实例化核心类
第一个参数是需要生成文档的文件夹路径
第二个参数可选,保存生成文档的路径,默认为当前目录
$apiDoc = new \Liluoao\ApiDoc('your-file-folder');
- 配置
包括你的文档名,和
snake_case
转换camelCase
的配置
$apiDoc->setName('doc-name');
$apiDoc->setCamel2SnakeConfig(false, false, 0, 0);
- 执行
$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}";
}