phpDocumentor死了吗?

2022-08-30 17:17:06

还是只是处于“完成”状态?我已经在我所有的PHP项目中使用PHPDoc很多年了,但我最近注意到PHPDoc网站上的最后一篇文章来自2008年。所以我想知道是否是时候研究其他替代品,如Doxygen。使用PHPDoc以外的其他东西有什么好处吗?

编辑:今天在Dev Zone上发表的有趣帖子,当Matthew宣布发布Zend Framework 1.11.5时,他写道:

“Mike van Riel提出将我们的API文档生成转换为DocBlox。我们已经在考虑过为ZF2使用它,但是看到模板系统的灵活性,更重要的是,对于我们来说,它在生成输出时所利用的速度和最少的资源方面,我们被卖掉了。(API 文档生成时间从 80-100 分钟减少到不到 10 分钟。您可以自己查看结果。http://devzone.zend.com/article/13643

这就是为什么我担心,如果像Zend Framework这样的大型项目正在放弃phpDoc,在我看来,phpDoc的不活跃并没有被忽视。100分钟到10分钟,这就是我喜欢听到的。

@gms8994好电话

*更新:所以事实证明DocBlox是伪装/重新命名的PHPDocumentor2。http://www.docblox-project.org/


答案 1

虽然我目前也使用doxygen,但我必须发布PHPDocumentor没有死。相反,DocBlox项目所做的尝试被加入进来,构成了PHPDocumentor2的基础,PHPDocumentor2是一个全新的网站。这些天我不相信它已经做好了生产准备,但它看起来确实很有前途。


答案 2

我最近使用Doxygen为PHP生成文档。这是用于文档的开源工具,也支持其他语言。我会说这是一个很好的工具,它很容易生成文档和类图,并且具有许多可配置的功能。它可用于Windows以及UNIX / LINUX

可以找到最新版本并在此处下载


推荐