php生成API文档

<?php
/**
 * 验证司机证书
 * @ApiMain => {"ApiName":"验证司机证书", "ApiDesc":"验证司机证书", "ApiUrl":"/third/yzDriverZhengShu", "ApiMethod":"POST"}
 * @ApiParam => {"name":"code", "desc":"验证码","type":"string", "value":"", "required":"true"}
 * @ApiParam => {"name":"user_mobile", "desc":"手机号","type":"string", "value":"", "required":"true"}
 * @ApiParam => {"name":"user_card_sn", "desc":"身份证","type":"string", "value":"", "required":"true"}
 * @ApiParam => {"name":"certificate_sn", "desc":"证书编号","type":"string", "value":"", "required":"true"}
 * @ApiReturn => {}
 * @ApiTime=> 20200728
 */
function parseApiFile($dir = '')
{
    $apiDoc = [];
    $rootPath = dirname(__FILE__);
    $dir = $rootPath . "/../app/Http/Controllers/Api/V15/";
    $arr = @scandir($dir);
    foreach ($arr as $v) {
        if ($v == "." || $v == "..") {
            continue;
        }
        $file = $dir . $v;
        $content = file_get_contents($file);
        $preg = "/\/\*[\S\s]+?\*\//";
        preg_match_all($preg, $content, $rows);
        if (!!$rows) {
            foreach ($rows[0] as $key => $row) {
                $tmpArr = toMakeArr($row);
                if ($tmpArr) {
                    $apiDoc[] = $tmpArr;
                }
            }
        }
    }
    return $apiDoc;
}

function toMakeArr($str)
{
    $info = [];
    $preg_router = "/@ApiMain[\S\s]+?\\n/";
    if (preg_match($preg_router, $str)) {
        $arr = explode("\n", $str);
        if ($arr) {
            foreach ($arr as $a) {
                $a = trimall($a);
                if ($a == "/" || !$a) {
                    continue;
                }
                $b = explode("=>", $a);
                if ($b[0] == "@ApiMain" && count($b) >= 2) {
                    $info = json_decode($b[1], true);
                }
                if ($b[0] == "@ApiParam" && count($b) >= 2) {
                    $info['ApiParam'][] = json_decode($b[1], true);
                }
                if ($b[0] == "@ApiReturn" && count($b) >= 2) {
                    $info['ApiReturn'] = $b[1];
                }
                if ($b[0] == "@ApiTime" && count($b) >= 2) {
                    $info['ApiTime'] = $b[1];
                }
            }
        }
    }
    return $info;
}

function arraySort($array, $keys, $sort = 'asc')
{
    $newArr = $valArr = array();
    foreach ($array as $key => $value) {
        $valArr[$key] = $value[$keys];
    }
    ($sort == 'asc') ? asort($valArr) : arsort($valArr);
    reset($valArr);
    foreach ($valArr as $key => $value) {
        $newArr[$key] = $array[$key];
    }
    return $newArr;
}

//删除空格 和 回车
function trimall($str)
{
    $oldchar = array("", " ", "\t", "\n", "\r", "*");
    $newchar = array("", "", "", "", "", "");
    return str_replace($oldchar, $newchar, $str);
}

$list = parseApiFile();
$list = arraySort($list, 'ApiTime', $sort = 'desc');
$menuStr = '';
foreach ($list as $key => $vo) {
    $menuStr .= "<li><a href='#p{$key}'>{$key}、{$vo['ApiName']}</a></li>";
}
$listStr = '';
foreach ($list as $key => $vo) {
    $listStr .= '<div class="interface-item">
                        <div class="item-tt" id="p' . $key . '">
                            <span>' . $vo['ApiName'] . '</span> <span class="line"></span>
                        </div>
                        <div class="item-bd">
                            <div class="item-lft">功能</div>
                            <div class="item-rt">' . $vo['ApiDesc'] . '</div>
                            <div class="item-lft">HTTP请求方式</div>
                            <div class="item-rt">' . $vo['ApiMethod'] . '</div>
                            <div class="item-lft">请求URL</div>
                            <div class="item-rt code">' . $vo['ApiUrl'] . '</div>
                            <div class="item-lft">请求参数</div>
                            <div class="item-rt">
                                <table width="100%">
                                    <tbody>
                                        <tr>
                                            <th width="15%">参数名称</th>
                                            <th width="15%">类型</th>
                                            <th width="10%">是否必须</th>
                                            <th width="40%">描述</th>
                                            <th width="20%">值</th>
                                        </tr>
                                    <form id="from_{{$vo . id}}" name="from_{{$vo . id}}">';
    if ($vo['ApiParam']) {
        foreach ($vo['ApiParam'] as $kk => $pp) {
            $listStr .= "<tr><td>{$pp['name']}</td><td>{$pp['type']}</td><td>{$pp['required']}</td><td>{$pp['desc']}</td><td>{$pp['value']}</td></tr>";
        }
    }

    $listStr .= '</form></tbody></table> </div>
                            <div class="item-lft">请求数据</div>
                            <pre class="item-rt code">' . $vo['ApiReturn'] . '</pre>
                        </div>
                    </div>';
}

$html = '
    <html>
        <head>
            <meta charset="utf-8">
            <meta name="viewport" content="width=device-width, initial-scale=1.0">
            <meta name="renderer" content="webkit">
            <title>API接口文档</title>
            <meta name="keywords" content="API接口文档">
            <meta name="description" content="API接口文档">
            <style>
                * {
                    margin: 0px;
                    padding: 0px;
                    font-size: 12px;
                    font-family: "微软雅黑";
                }

                .red {
                    color: #ffffff;
                }

                body {
                    min-width: 1000px;
                }

                .contenttt {
                    background: #fff;
                    position: fixed;
                    right: 20px;
                    top: 20px;
                    _position: absolute;
                    _top: expression(offsetParent.scrollTop +20);
                    _left: expression(offsetParent.width);
                    z-index: 2000;
                    border: 1px solid #d7d7d7;
                    width: 400px;
                    padding-bottom: 10px;
                }
                .content{
                    margin: 5px;
                    width: 15%;
                    float: left;
                    background: #f8f8f8;
                    border: 1px dashed #d7d7d7;
                    border-radius: 10px;
                }

                .content .content-title h1 {
                    font-size: 14px;
                    height: 24px;
                    line-height: 24px;
                    padding-left: 10px;
                }

                .content .content-body {
                    padding-left: 20px;
                }

                .content .content-body li {
                    list-style: none;
                    height: 20px;
                    line-height: 20px;
                    width: 220px;
                    float: left;
                }

                .content .content-body li a {
                    font-size: 12px;
                    text-decoration: none;
                }

                .content .content-body li a:hover {
                    text-decoration: underline;
                }

                .box {
                    padding-left: 20px;
                    float:right;
                    width: 80%;
                }

                .box-title {
                    font-size: 14px;
                    font-weight: bold;
                    color: #555;
                    height: 36px;
                    line-height: 36px;
                    border-bottom: 1px solid #d0dfed
                }

                .box-notice {
                    padding-bottom: 20px;
                }

                .notice-title {
                    height: 24px;
                    line-height: 24px;
                    font-size: 13px;
                    font-weight: bold;
                }

                .notice-body {
                    padding-left: 24px;
                    line-height:22px;
                }

                .notice-body li {
                    list-style-type: square;
                }

                .interface-title {
                    height: 34px;
                    line-height: 34px;
                    background: #f6faff;
                    border: 1px solid #becfdd;
                    color: #333;
                    padding-left: 10px;
                    font-size: 13px;
                    font-weight: bold;
                }

                .item-tt {
                    position: relative;
                    height: 30px;
                    line-height: 30px;
                    margin: 10px 0px;
                }

                .item-tt span {
                    color: #0455CA;
                    font-size: 14px;
                    font-weight: bold;
                    background: #fff;
                    position: relative;
                    background: #fff;
                    z-index: 21;
                    padding: 0px 10px;
                }

                .item-tt span.line {
                    border-bottom: 1px dashed #666;
                    display: block;
                    position: relative;
                    top: -15px;
                    z-index: 20;
                }

                .item-bd {
                    padding-left: 30px;
                    overflow: hidden;
                    background: #d7d7d79c;
                    border-radius: 10px;
                }

                .item-bd ul li {
                    list-style: none;
                    height: 24px;
                    line-height: 24px;
                }

                .item-lft,.item-rt {
                    float: left;
                    line-height: 24px;
                    margin: 10px 0px;
                }

                .item-lft {
                    clear: both;
                    width: 140px;
                    font-weight: bold;
                    text-align: right;
                }

                .item-rt {
                    margin-left: 20px;
                    width: 70%;
                    padding-left: 10px;
                }

                .code {
                    border: 1px dashed #999;
                    background: #fafafa;
                    color: #555;
                    font-family: "Courier New";
                    margin-left: 30px;
                    width: 69%;
                    border-radius: 5px;
                }

                table {
                    border-collapse: collapse;
                    border: 1px solid #EDECEC;
                }

                table th,table td {
                    border: 1px solid #ccc
                }

                table th {
                    line-height: 30px;
                    background: #f8f8f8
                }

                table td {
                    line-height: 30px;
                    padding-left: 10px;
                }

                table tr.odd {
                    background: #fbfbfb
                }

                .interface-item {
                    clear: both;
                }
                .demolist li{float:left;margin:0px 10px;}
            </style>

        </head>

        <body style="position:relative;">
            <div class="content">
                <div class="content-title">
                    <h1>目录</h1>
                </div>
                <ul class="content-body">' . $menuStr . '</ul>
            </div>
            <div class="box">
                <div class="box-title">API接口文档</div>
                    ' . $listStr . '
                </div>
            </div>
        </body>
    </html>';

echo $html;
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,088评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,715评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,361评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,099评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 60,987评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,063评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,486评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,175评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,440评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,518评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,305评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,190评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,550评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,880评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,152评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,451评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,637评论 2 335

推荐阅读更多精彩内容