有什么比 PHPDoc 更好的吗？ [关闭]答案

【问题标题】：Anything better than PHPDoc out there? [closed]有什么比 PHPDoc 更好的吗？ [关闭]
【发布时间】：2010-09-11 04:44:12
【问题描述】：

除了PHPDoc?，还有人使用其他任何东西来记录他们的PHP 代码吗？是否有任何工具可以读取相同的文档语法但提供更丰富的输出？

【问题讨论】：

【解决方案1】：

除了 phpDocumentor 之外的另一个选项是带有 PHP 支持的 Doxygen 文档。

【讨论】：

【解决方案2】：

我没有将它与 PHP 一起使用，但 doxygen 声称支持该语言。

【讨论】：

【解决方案3】：

ApiGen

ApiGen 支持 PHP 5.3 命名空间、包、文档之间的链接、对 PHP 标准类和通用文档的交叉引用、创建突出显示的源代码以及对 PHP 5.4 特征的实验性支持。

适用于各种规模和持续集成的项目的 PHP 5.3 兼容 API 文档生成器。

能够完全解析和转换 Zend Framework 2

【讨论】：

apigen.org 是 lovley，我现在一直在使用它。它支持命名空间并且也有一个可爱的代码输出。这是我的 ant 配置：<target name="apigen" description="API documentation using apigen -- http://apigen.org/"> <exec executable="apigen.bat"> <arg value="--source" /> <arg path="${basedir}/lib" /> <arg value="--destination" /> <arg path="${basedir}/build/docs" /> </exec>

【解决方案4】：

如果您需要记录 PHP 5.3+ 的代码，例如。如果它使用命名空间 Ted Kulp 的 fork of PHPDoctor 可能是您的答案。

【讨论】：

【解决方案5】：

你可以试试 DocBlox；它旨在成为 phpDocumentor 的替代方案，但支持附加功能，其中完整的 PHP 5.3 支持是其中之一。另一个好处是它非常快并且使用的内存相对较少。

【讨论】：

【解决方案6】：

Doctrine 使用 PHPDoctor，在我的测试中它似乎与 5.3 配合得很好。

【讨论】：

【解决方案7】：

我也在使用Doxygen - 你很快就习惯了各种关键字 - 它们是不言自明的。 ;)

RubyDoc 也不错，我特别喜欢他们的 rdocs 布局。

【讨论】：

【解决方案8】：

Doxygen (www.doxygen.org)。

【讨论】：

【解决方案9】：

我也会选择 doxygen。

这里有几个原因：

而且仍然是免费的、多平台的和开源的 :-)

它很容易学习，但比 phpdoc 更难，因为它更丰富。

【讨论】：