KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

php_api_doc

★ 56 Open GitHub ↗

PHP API 文档

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# php_api_doc

![效果图](https://xinliangcoder.github.io/image/api_doc_1.png)

> 配置

- 将文件夹复制到到项目根目录即可。
- 设置 api_doc/config/config.php 中 SYSTEM_CLASS_DIR 。
- 赋予 api_doc/class 文件夹 777 权限。

> 方法注释

- 事例一：
```
/**
* 批量获取用户基本信息
* @desc 用于获取多个用户基本信息
* @return int    code 操作码，0表示成功
* @return array  list 用户列表
* @return int    list[].id 用户ID
* @return string list[].name 用户名字
* @return string list[].note 用户来源
* @return string msg 提示信息
*/
public function getMultiBaseInfo()
{
    return [];
}
```
- 事例二：
```
/**
 * 获取用户基本信息
 * @desc 用于获取单个用户基本信息
 * @return int    code 操作码，0表示成功， 1表示用户不存在
 * @return object info 用户信息对象
 * @return int    info.id 用户ID
 * @return string info.name 用户名字
 * @return string info.note 用户来源
 * @return string msg 提示信息
 */
public function getBaseInfo()
{
    return [];
}
```

> 传递参数注释

- 在文件头部或底部配置每个方法的传入参数

```
/**
 * API_DOC 设置方法传参
 * @return array
 */
public function getRules()
{
    return [
        'getBaseInfo' => [
            'userId' => [
                'name'    => 'user_id',
                'type'    => 'int',
                'min'     => 1,
                'require' => true,
                'desc'    => '用户ID'
            ],
        ],

'getMultiBaseInfo' => [
            'userIds' => [
                'name'    => 'user_ids',
                'type'    => 'array',
                'format'  => 'explode',
                'require' => true,
                'default' => '10',
                'range'   => [10,100],
                'desc'    => '用户ID，多个以逗号分割'
            ],
        ],
    ];
}
```

微信名称：新亮笔记，微信号：XinLiangTalk。

![新亮笔记](https://xinliangcoder.github.io/image/qr.jpg)

> 日志

- 新增支持多级目录问题

php_api_doc

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README