【发布时间】:2011-08-20 09:11:04
【问题描述】:
我在 Mac OS X 10.6 上使用 vanilla Zend Studio 8 和一个简单的测试项目。
当我使用 phpDocumentor(使用默认设置)生成文档时,生成的文档不包含任何类属性 - 即使我为它们编写了有效的文档块。
例子:
/**
* The number of characters of the text.
* It is used to prevent the program from operating beyond the end of the text.
* @var int
*/
public $length;
上述属性不会出现在生成的文档中。
但是,如果我将 public 更改为 var(即将我的代码从 PHP 4 更改为 PHP 5 语法),那么这些属性就会出现在文档中。
关于导致此问题的原因或如何解决此问题的任何想法?
编辑:我刚刚将 phpDocumentor 与 Zend Studio 安装分开安装,并尝试以这种方式生成文档 - 它在 Zend Studio 之外完美工作,并且所有属性都显示出来突出显示的源代码。
所以这似乎只是 Zend Studio 本身、它的 phpDocumentor 集成副本或它的 PHP 集成副本的问题。
【问题讨论】:
-
当我不久前尝试使用 phpdocumentor 时,这也让我感到困惑。
-
使用最实际的版本。但是,phpDocumentor 似乎有一段时间缺乏开发。考虑使用其他工具,例如 docblox。
-
phpDoc 似乎可以满足我的需求。虽然能够直接在 Zend Studio 中生成文档会很好,但我不介意在独立安装的 phpDoc 上使用 Web 界面。我可能会查看其他文档包,谢谢。仍然会很好地解决这个问题。
标签: php zend-studio phpdoc