/**
* 1.以输入的目录分目录,proxy,user,site
* 2.以@package分文件,site.html,vhost.html
*/
class apiDoc
{
static $round = 1;
static $testArr = array();
static $docPackage = '';
public static function targetApiDir($dir)
{
$apiDir = API_PATH.$dir."/";
self::$docPackage = API_DOC_DIR.$dir;
self::parseApiFile($apiDir);
}
public static function parseApiFile($dir)
{
$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) {
$arr = self::doWithBlocQuote($row);
self::$testArr[$arr['package']][$arr['router']."-".$arr['method']] = $arr;
}
}
}
if (self::unitDocDir(API_DOC_DIR)) {
self::createDocHtml();
}
echo "创建成功";
print_r(self::$testArr);
}
private static function doWithBlocQuote($row)
{
$router = "";
$param = array();
$method = '';
$package = '';
$return = '';
$description = '';
$preg_router = "/@router[\S\s]+?\\n/";
if (preg_match($preg_router, $row)) {
$arr= explode("\n", $row);
foreach ($arr as $a) {
$a = trim($a);
$a = trim($a,"*");
$a = trim($a,"\t");
$a = trim($a,"\n");
if ($a == "/" || !$a) {
continue;
}
$a = preg_replace('/\s(?=\s)/', '\\1', ltrim($a, " "));
$b = explode(" ", $a);
if ($b[0] == "@description" && count($b) >= 2) {
$b[1] = self::contactRemains($b, 2);
$description = $b[1];
}
if ($b[0] =="@package" && count($b) >= 2) {
$package = $b[1];
}
if ($b[0] == "@router") {
$router = $b[1];
}
if ($b[0] =="@method") {
$method = $b[1];
}
if ($b[0] =="@param" && count($b) >= 3) {
$b[3] = self::contactRemains($b, 4);
array_push($param, array("type"=>$b[1],"name"=>$b[2], "description"=>$b[3]));
}
if ($b[0] =="@return") {
$return = $b[1];
}
}
return array(
'description'=>$description,
'package' => $package,
'router' => $router,
'method' => $method,
'param' => $param,
'return' => $return
);
}
}
private static function headHtml($title, $content)
{
$tpl = '
%s

href="/asset/css/layui.css" rel="stylesheet"/>
href="/asset/css/common.css" rel="stylesheet"/>

.layui-form-label, .layui-form-mid, .layui-table th, .layui-table td{padding-bottom:5px;padding-top:5px;}
.layui-form{padding-bottom:10px;margin-bottom:10px;}

';
return sprintf($tpl,$title, $content, $title);
}
private static function createContentHtml($descript, $router, $method, $params)
{
$paramHtml = '';
if (count($params) > 0) {
foreach ($params as $param) {
$paramHtml.= sprintf('%s%s%s', $param['name'], $param['type'], $param['description']);
}
} else {
$paramHtml =  '无';
}
$html = '

';
return sprintf($html, $descript, $router, $method, $paramHtml);
}
private static function createDocHtml()
{
foreach (self::$testArr as $package=>&$list) {
ksort($list);
$html = '';
foreach ($list as $k=>$v) {
$html.= self::createContentHtml($v['description'], $v['router'], $v['method'], $v['param']);
}
$webname = sessionGet("web_name");
if (!$webname) {
$webname = SystemMod::webName();
}
self::createDocTempFile($package, self::headHtml($webname, $html));
}
}
private static function contactRemains($arr, $remains)
{
$str = '';
if (count($arr) >= $remains) {
$str = '';
for ($i = $remains - 1; $i < count($arr);$i++){
$str.= $arr[$i];
}
}
return $str;
}
private static function createDocTempFile($package, $content, $filename = null)
{
if (!is_dir(self::$docPackage)) {
mkdir(self::$docPackage, 775, true);
}
$newFile = self::$docPackage."/".$package.".html";
file_put_contents($newFile, $content.PHP_EOL, FILE_APPEND);
}
private static function unitDocDir($dir)
{
$arr = scandir($dir);
foreach ($arr as $v) {
if ($v == "." || $v == "..") {
continue;
}
$subDir = $dir."/".$v;
if (is_file($subDir)) {
unlink($subDir);
} else {
if (count(scandir($subDir)) > 2) {
self::unitDocDir($subDir);
}
rmdir($subDir);
}
}
return true;
}
}