获取 php 文件中的注释

Question

我一直试图从我服务器上的某个 .php 文件中取出 cmets，以便解析它的变量。我以为我找到了一个简单的方法来做到这一点，然而，我使用的函数没有返回任何内容，即使我在文件中显然有 cmets。

这是我使用的 cmets：

/**
* @param  foo bar
* @return baz
*/

这是我的代码：

function GetComments($filename) {

    $expr = "/((?:\/\*(?:[^*]|(?:\*+[^*\/]))*\*+\/)|(?:\/\/.*))/";

    $file = fopen($filename, "r");
    $length = filesize($filename);
    $comments = fread($file, $length);
    fclose($file);

    preg_match_all($expr, $comments, $matches);

    foreach($matches[0] as $id => $variable){
        $comments = str_replace($variable,'',$comments);
    }

    return $comments;
}

我做错了什么吗？因为如果是这样，我显然是在看它。

非常欢迎任何帮助。

编辑：

我找到了答案：

首先，我可能应该在我的问题中指出我正在尝试编写一个用于读取插件的系统。这些插件文件应在顶部包含一个注释块，其中包含插件的作者、网站、电子邮件等变量。

这就是我所做的：

我以feeela 的例子来改变我的函数来获取cmets 和它的变量。
然后我稍微更改了它的代码以满足我的需要：

public function GetComments($filename)
{

    $docComments = array_filter(token_get_all(file_get_contents($filename)), function($entry)
    {
        return $entry[0] == T_COMMENT;
    });
    $fileDocComment = array_shift($docComments);

    $regexp = "/\@.*\:\s.*\r/";
    preg_match_all($regexp, $fileDocComment[1], $matches);

    for($i = 0; $i < sizeof($matches[0]); $i++)
    {
        $params[$i] = split(": ", $matches[0][$i]);
    }

    return($params);
}

我把feeela给我的代码结果通过正则表达式匹配，得到一个包含参数及其值组合的数组。
然后我使用 split 函数实际上给了我单独的参数和值，所以我可以将它们返回给调用该函数的变量。

为了让它正常工作，我需要更改我使用的评论样式

/**
* @param foo bar
* @return baz
*/

到

/*
@param: foo bar
@return: baz
*/

使其成为普通的注释块，而不是文档注释块。
它还使我能够使用 ':' 作为拆分功能的模式。

在某些人看来，它可能“效率不高”。正如feeela 所说，“如果您的评论风格发生变化怎么办？”。我将是唯一一个在这个项目上工作并编写插件的人。因此，在每个插件脚本中保持相同的注释样式对我来说也不会太难。
这种方法对我来说非常有效。

感谢大家对此的帮助。

Answer 1

看看Comment Manager。它是一组用于解析 DocBloc cmets 的 Php 类。它还允许根据 DocBlock cmets 中的信息验证函数参数值

Answer 2

您可以使用token_get_all()，它“使用 Zend 引擎的词法扫描器将给定的 PHP 源字符串解析为语言标记”。

见：http://php.net/token_get_all

这是我曾经用来从当前文件中获取文件文档注释的示例函数：

/**
 * Return first doc comment found in this file.
 * 
 * @return string
 */
function getFileDocBlock()
{
    $docComments = array_filter(
        token_get_all( file_get_contents( __FILE__ ) ), function($entry) {
            return $entry[0] == T_DOC_COMMENT;
        }
    );
    $fileDocComment = array_shift( $docComments );
    return $fileDocComment[1];
}

Answer 3

尝试使用 http://ca3.php.net/manual/en/class.reflectionclass.php

和 http://ca3.php.net/manual/en/class.reflectionfunction.php

这都是你需要获取的函数参数。