如何从不使用类的 PHP 脚本中提取文档注释？

Question

我知道 PHP ReflectionClass 可以从 PHP 脚本中获取 doc cmets。现在我遇到了数百个不使用类而只使用简单公共函数的旧 PHP 脚本。如果我是对的，ReflectionClass 不能在这里使用吗？我的目标是提取每个文档 cmets。例如。 test1.php 包含以下几行：

<?php
/**
 * some main comments here
 */
...some php lines here...

/**
 * function comment
 * Blah blah
 */
function foo()
{
 ...some php lines here...
}
...and more functions below each with comments

?>

所以我想要的输出是这样的表格：

--------------------------------------------------
| Filename  | FUNCTION | Comment                 |
--------------------------------------------------
| test1.php |          | some main comments here |
| test1.php | foo()    | function comment        |
|           |          | Blah Blah               |

Answer 1

您可以使用ReflectionFunction

$functions = get_defined_functions();

foreach ($functions['user'] as $function) {

    $reflection = new ReflectionFunction($function);

    var_dump($reflection->getName());
    var_dump($reflection->getDocComment());
}

结果将是（如果您只定义了 foo 函数）：

string(3) "foo"
string(43) "/**
 * function comment
 * Blah blah
 */"