自动生成PHP文档？

Question

对于ActionScript 2，我使用了NaturalDocs。但是它对PHP的支持很差。到目前为止，我看到了doxygen和phpDocumentor，但在我看来，他们的输出非常难看。有没有人有PHP自动文档生成的经验？我更喜欢能够使用javadoc风格的标签，它们很容易编写并且易于记忆。

Answer 1

ApiGen

http://apigen.org/

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

DocBlox

http://www.docblox-project.org/

PHP 5.3兼容的API文档生成器，针对各种规模的项目和持续集成。

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

Answer 2

有两个众所周知且经常使用的工具可以从docblocks生成API文档：

• phpDocumentor，特定于PHP，可能是PHP项目最常用的工具之一
• 和Doxygen，更多用于C，但有些人用于PHP。

关于“指南”：我会说这取决于你的项目，但至少，我希望看到：

• 方法/功能的描述
• 参数，@param type name description of the parameter
• 返回值，@return type description of the return value
• 例外，@throws type description of the exception that can be thrown

最近的IDE （例如Eclipse PDT ）可以读取和解释这些标记，以便在编码时提供提示，这很棒！ - ）

此外，有越来越多的PHP工具将php docblock用于除文档之外的其他目的。

例如，PHPUnit允许您使用某些特定标记指定一些与测试相关的内容 - 请参阅Annotations。

Answer 3

PHPDoc在Javadoc样式内联注释方面可能会得到很好的效果。您可能还想查看PHPXRef。

Answer 4

是的，phpDocumentor（http://www.phpdoc.org/）是PHP autodocs可接受的标准工具。这是事实上的标准。

在记录PHP代码时，遵循一般的JavaDoc代码指南是可以接受的。但是，你会遇到这样的情况，因为PHP和Java是不同的语言。

例如，PHP函数没有返回类型，并且函数返回一个具有一个上下文的类型并且在另一个上下文中返回另一个类型是不可避免的（有时是可取的）。 JavaDoc指南对此没有帮助，因为用Java做这件事是不可能的。

Answer 5

phpDocumentor可以输出类似于php.net文档的样式（并且内置了智能和非智能布局）

Answer 6

查看PHPDoctor http://peej.github.com/phpdoctor/，这是一个用于PHP的简单但完整的Javadoc克隆功能。

Answer 7

使用phpdoc标签记录Wordpress代码库（请参阅this），它通常非常好 - 使用here呈现phpDocumentor。

我编写的大部分代码都足够重要，我需要考虑自动生成文档，这是在.Net中完成的，所以我不能给出很多文档编写者的观点

Answer 8

如果丑陋是个问题，我只需将样式表切换为自定义样式表。如果您不想覆盖生成的插件，可以使用像Stylish这样的Firefox插件。

Answer 9

您可以编辑模板文件以添加自己的样式表以覆盖现有样式表。