php - Doxygen 在记录 PHP 时出现奇怪的问题

Question

我在尝试记录我的项目时遇到了一个奇怪的问题。我有以下代码:

//! Set default ::$action for called controller. If no action is called, default (index) will be set.
$action = isset($_GET[ 'action']) ? $_GET[ 'action'] : 'index';

if ($action) {
    echo 'something 1';
}else{
    echo 'something 2';
}

//! Set default ::$action2 for called controller. If no action is called, default (index) will be set.
$action2 = isset($_GET[ 'action']) ? $_GET[ 'action'] : 'index';

//! Set default ::$action3 for called controller. If no action is called, default (index) will be set.
$action3 = isset($_GET[ 'action']) ? $_GET[ 'action'] : 'index';

Doxygen 生成以下内容:

如您所见，缺少 $action2。我检查了我的其他文件之一，发现了同样的问题。 if 语句之后的下一件事从未被记录下来，但之后的那个被记录下来。如果我从上面的示例中删除 if 语句，我将获得所有 4 个变量的文档 - $page、$action、action2 和 action3。

我花了很多时间试图了解到底哪里出了问题，但运气不好，所以欢迎大家提出建议。

系统是:带有 Doxygen 1.7.4 的 Windows XP x64。 (我正在使用 Doxygen GUI)

更新此外，当我的代码中有类似内容时(请注意 if 语句中缺少的 else)。但是当我添加 }else{} 时它起作用了。接下来的 $variables 没有再次记录，但该更新是关于 if/else 的。

Doxygen 将它转换成这个

Answer 1

看看这个 http://www.doxygen.nl/manual/autolink.html这解释了您在第一个代码片段中看到的奇怪之处。

不幸的是，Doxygen 不能很好地记录程序 PHP 代码，并且在检查了我自己的所有 doxygen 生成的文档之后，我找不到任何函数或方法的任何记录变量，除非它们是定义的类属性。

否则，我认为最大的 PHP Doxygen 友好项目是 Drupal，他们的指导方针是为了充分利用 Doxygen 的评论处理系统而编写的。 http://drupal.org/node/1354

请注意，如果这不是您要找的答案或者我完全偏离目标，请立即告诉我，以便我删除此答案。