有什么比PHPDoc更好的吗?

时间:2008-09-19 11:16:13

标签: php documentation documentation-generation phpdoc

是否有人使用其他任何内容来记录他们的PHP代码,而不是PHPDoc? 是否有任何工具可以读取相同的文档语法但提供更丰富的输出?

9 个答案:

答案 0 :(得分:18)

我也会选择doxygen。

以下是几个原因:

  • 与phpdoc标签和其他流行标签兼容:可互操作
  • 适用于各种编程语言:更好的时间投资
  • 有其他语法:可以选择适合你的评论风格
  • 使用高级格式化/标记/元数据非常高效
  • 有一个GUI没有链接到任何IDE和eclipse插件

仍然免费,多平台,开源: - )

学习起来很容易,但是phpdoc更难,因为它更丰富。

答案 1 :(得分:8)

你可以尝试DocBlox;它旨在成为phpDocumentor的替代品,但支持完整的PHP 5.3支持的其他功能。另一个好处是它非常快并且使用的内存相对较少。

您可以在http://www.docblox-project.org上阅读更多内容,或在http://demo.docblox-project.org/default

查看演示

答案 2 :(得分:6)

phpDocumentor以外的另一个选项是Doxygen支持PHP的文档。

答案 3 :(得分:4)

Doxygen(www.doxygen.org)。

答案 4 :(得分:3)

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

答案 5 :(得分:2)

我也在使用Doxygen - 你很快习惯了各种关键词 - 它们是一种自我解释。 ;)

RubyDoc也很不错,我特别喜欢它们的rdocs布局。

答案 6 :(得分:2)

我没有在PHP中使用它,但doxygen声称支持该语言。

答案 7 :(得分:2)

Doctrine使用PHPDoctor,在我的测试中看起来与5.3兼容。

http://peej.github.com/phpdoctor/#download

答案 8 :(得分:1)

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