phpDocumentor死了吗?

时间:2011-04-07 16:33:29

标签: php doxygen phpdoc

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

编辑:当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/

5 个答案:

答案 0 :(得分:2)

虽然我目前也使用doxygen,但我必须发布PHPDocumentor并没有死。相反,DocBlox项目所做的尝试将成为构成全新网站PHPDocumentor2的基础。这些天我不相信它的生产准备就绪,但它看起来确实很有希望。

答案 1 :(得分:1)

为什么修复没有破坏的东西? PHPDoc很棒,不需要其他任何东西。他们不是在尝试创新,只是为了帮助创建文档。他们做得很好。

答案 2 :(得分:1)

我有几个phpDocumentor的问题。其中一个是xml导出。在尝试修复代码之后,我决定寻找替代方案。

我发现和喜欢的是:Rarangi https://bitbucket.org/laurentj/rarangi/wiki/Home

Rarangi is a generator of documents from php source code.

有趣的是它将信息保存在mysql数据库中,您可以制作自己的自定义报告。

答案 3 :(得分:1)

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

Can Find the latest release and DOWNLOAD Here

答案 4 :(得分:0)

phpDocumentor v3(具有适当的PHP 7支持)目前是alpha版本,非常接近稳定版本。问题是他们工作的人很多,所以开发很慢。

我已经在我的一个Symfony项目中测试了最新的Alpha版本,尽管它缺少一些功能并有一些错误,但它的工作还可以。他们都被报道了。

https://github.com/phpDocumentor/phpDocumentor/releases

更新:phpDocumentor v3刚刚发布测试版。检查发布。