使用反射提取项目中函数和类定义原型和注释
前几天有朋友希望得到 thinkphp 全部函数和类定义的文档。手工整理出来也的确很费事。
为此，用 php 的反射功能写了一个程序。
欢迎拍砖！if(isset($_get['fn'])) new appdoc($_get['fn']);
else {
$path = 'thinkphp';
//$path = 'phpcms';
//$path = 'wordpress';
new appdoc(realpath($path));
}
class appdoc {
private $data = array();
private $next = array();
function __construct($path='') {
if(is_array($path) || is_file($path)) return $this->analysis($path);
$res = glob($path . directory_separator . '*', glob_nosort);
$next = array();
for($i=0; $isave($this->load($fn));
if($s) $this->next[$s] = $fn;
}
$this->checknext();
$s = join(php_eol.php_eol, $this->data);
if(mb_check_encoding($s, 'utf-8')) $s = iconv('utf-8', 'gbk', $s);
header(content-type: text/plain;charset=gbk);
echo $s, php_eol . php_eol;
echo '文件列表' . php_eol;
echo join(php_eol, $res);
if($this->next) {
echo php_eol . php_eol . '残余的' . php_eol;
print_r($this->next);
}
}
private function load($fn) {
$u = is_array($fn) ? http_build_query(array('fn' => array_values($fn))) : fn=$fn;
$url = http://$_server[http_host]$_server[php_self]?$u;
$curl = curl_init();
curl_setopt($curl, curlopt_url, $url);
curl_setopt($curl, curlopt_returntransfer, true);
return curl_exec($curl);
}
private function checknext() {
foreach($this->next as $s=>$fn) {
switch(1) {
case is_numeric($s): break;
case preg_match(/class '(\w+)' not found/, $s, $m) :
$m = preg_quote($m[1]);
foreach(preg_grep(/class $m/i, $this->data) as $r) {;
if(preg_match('/@@\s+(\s+)/', $r, $m)) {
array_unshift($this->next, $m[1]);
break;
}
}
break;
}
}
$u = http_build_query(array('fn' => array_values($this->next)));
$s = $this->save($this->load($this->next));
$this->next = array();
if(empty($s)) unset($this->next[$s]);
else $this->next[] = $s;
}
private function save($s) {
if(empty($s) || preg_match('/~runtime.php/i', $s)) return '';
if(preg_match('#fatal error#', $s)) return $s;
$t = array();
$ar = preg_split(/[\r\n]+/, $s);
foreach($ar as $i=>$v) {
$t[] = $v;
if($v == '}') {
$t = join(php_eol, $t);
if(! in_array($t, $this->data)) $this->data[] = $t;
$t = array();
}
}
return '';
}
private function import($fn) {
ob_start();
if(is_array($fn)) foreach($fn as $f) include_once($f);
else include_once($fn);
ob_end_clean();
}
private function analysis($fn) {
if(! is_array($fn) && preg_match('/~runtime.php$/i', $fn)) return;
$last = get_defined_constants();
$this->import($fn);
if($t = array_diff($last, get_defined_constants())) {
echo 'constants' . join(php_eol . \t, $t) . php_eol . php_eol;
}
foreach(get_defined_functions()['user'] as $name) {
$func = new reflectionfunction($name);
reflection::export($func);
}
foreach(get_declared_classes() as $name) {
if(__class__ == $name) continue;
$class = new reflectionclass($name);
if($class->isuserdefined()) {
reflection::export($class);
}
}
foreach(get_declared_interfaces() as $name) {
$interfaces = new reflectionclass($name);
if($interfaces->isuserdefined()) {
reflection::export($interfaces);
}
}
}
}

------解决方案--------------------
说真的，这个方式虽然看方法之类的全一些，但感觉要比手册差远了。
最好的还是直接看源码，看看注释，参数之类就够了，况且还是中文的。
------解决方案--------------------
赞一个，斑竹最近很闲啊。
------解决方案--------------------
赞一个。
------解决方案--------------------