PHP 结合 apidoc生成文档树

apidoc的使用可以参考http://apidocjs.com/

以下是使用PHP生成 apidoc能解析的文档树，方便开发人员尽快的输出文档，以下是方法，
将其放到公共控制器下，每次请求都调用一下，时时监听api.log，会生成一个

/**
* @api {post} login/index1
* @apiName index1
* @apiGroup login
*
* @apiParam {string} mobile
*
* @apiSuccess {int} errcode
* @apiSuccess {string} errmsg
* @apiSuccess {object} data
* @apiSuccess {string} data.mobile
* @apiSuccess {string} data.is_create
*
* @apiSuccessExample Success-Response:
{
“errcode”: 0,
“errmsg”: “操作成功”,
“data”: {
“mobile”: “12345678910”,
“is_create”: “1”
}
}
*/

如下生成的代码：

/** * 创建apidoc文档 * @param $data */public function create_api($data) {    $str = "/**" . PHP_EOL;    $url = uri_string();    $str .= ' * @api {' . strtolower($_SERVER['REQUEST_METHOD']) . '} ' . $url . PHP_EOL;    list($one, $two) = explode('/', $url);    $str .= ' * @apiName ' . $two . PHP_EOL;    $str .= ' * @apiGroup ' . $one . PHP_EOL;    $str .= ' *' . PHP_EOL;    $request = $this->input->post(null);    if (!empty( $request )) {        foreach ($request as $k => $v) {            if ($k == 'is_create') {                continue;            }            $str .= ' * @apiParam {string} ' . $k . PHP_EOL;        }        $str .= ' *' . PHP_EOL;    }    $str .= $this->get_re($data, '', 1);    $str .= ' *' . PHP_EOL;    $str .= ' * @apiSuccessExample Success-Response:' . PHP_EOL;    $str .= json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);    $str = str_replace(['integer', 'array'], ['int', 'object'], $str);    $str .= PHP_EOL . ' */' . PHP_EOL;    $config =& get_config();    file_put_contents($config['log_path'] . '/api.log', PHP_EOL . $str, FILE_APPEND);}public function get_re($data, $pre = '', $deep = 1) {    if ($deep > 10) {        return false;    }    global $str;    foreach ($data as $index => $item) {        $is_num = is_numeric($index);        $is_arr = is_array($item);        if ($is_arr) {            if ($is_num) {                if (strpos($str, $pre)) {                    break;                } else {                    $this->get_re($item, $pre, $deep);                }            } else {                $str .= ' * @apiSuccess {' . gettype($item) . '} ' . $pre . $index . PHP_EOL;                $deep = $deep + 1;                $this->get_re($item, $pre . $index . '.', $deep);            }        } else {            $str .= ' * @apiSuccess {' . gettype($item) . '} ' . $pre . $index . PHP_EOL;        }    }    return $str;}