有没有人使用其他任何东西来记录他们的PHP
代码PHPDoc?
是否有任何工具可以读取相同的文档语法但提供更丰富的输出?
9 回答
我也会去吃doxygen。
这里有几个原因:
- 与 phpdoc 标签和其他流行标签兼容:它是可互操作的
- 与各种编程语言一起工作:更好的时间投资
- 有替代语法:可以选择适合您的评论风格
- 使用高级格式化/标记/元数据非常有效
- 有一个未链接到任何 IDE 的 GUI 和一个 Eclipse 插件
而且仍然是免费的、多平台的和开源的:-)
它很容易学习,但比 phpdoc 更难,因为它更丰富。
你可以试试 DocBlox;它旨在成为 phpDocumentor 的替代方案,但支持附加功能,其中完整的 PHP 5.3 支持是其中之一。另一个好处是它非常快并且使用的内存相对较少。
您可以在http://www.docblox-project.org上阅读更多内容,或在http://demo.docblox-project.org/default上查看演示
Doxygen ( www.doxygen.org )。
ApiGen
ApiGen 支持 PHP 5.3 命名空间、包、文档之间的链接、对 PHP 标准类和通用文档的交叉引用、突出显示的源代码的创建以及对 PHP 5.4 特征的实验性支持。
DocBlox
http://www.docblox-project.org/
PHP 5.3 兼容 API 文档生成器,针对各种规模和持续集成的项目。
能够完全解析和转换 Zend Framework 2
我没有将它与 PHP 一起使用,但doxygen声称支持该语言。
Doctrine 使用 PHPDoctor,在我的测试中它似乎与 5.3 配合得很好。
如果您需要记录 PHP 5.3+ 的代码,例如。如果它使用命名空间 Ted Kulp 的PHPDoctor 分支可能是您的答案。