phpDocumentor 死了吗？
或者它只是处于“完成”状态？我在所有 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/
Or is it just at a 'finished' state? I've used PHPDoc for many years on all my PHP projects, but I recently noticed that the last post on the PHPDoc website was from 2008. So I'm wondering if it's time to look into other alternatives like Doxygen. Are there any advantages to using something other than PHPDoc?
EDIT: Interesting post on Dev Zone today when Matthew announced the release of Zend Framework 1.11.5 he wrote:
"Mike van Riel offered to convert our API documentation generation to DocBlox. We'd already been considering it for ZF2, but on seeing the flexibility of the templating system, and, more importantly for us in terms of packaging, the speed and minimal resources it utilizes in generating the output, we were sold. (API documentation generation time was reduced from taking 80-100 minutes to less than 10.) You can view the results for yourself." http://devzone.zend.com/article/13643
This is why I'm concerned, if large projects like Zend Framework are dropping phpDoc, it seems to me the inactivity of phpDoc is not going unnoticed. 100 minutes down to 10..that's what I like to hear.
@gms8994 good call
*UPDATE: So turns out DocBlox is PHPDocumentor2 in disguise/re-branded. http://www.docblox-project.org/
如果你对这篇内容有疑问，欢迎到本站社区发帖提问 参与讨论，获取更多帮助，或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱，如果其他用户或者作者回复了您的评论，将不能在第一时间通知您！
发布评论
评论（5）
虽然我目前也使用 doxygen，但我必须指出 PHPDocumentor 并没有消亡。相反，DocBlox 项目所做的尝试被结合起来，形成了 PHPDocumentor2 这是一个全新的网站。这些天我不相信它已经准备好投入生产，但它看起来确实很有前途。
Although I currently use doxygen, too, I have to post that PHPDocumentor is not dead. Instead the attempts made by the DocBlox project are joined to form the basis for PHPDocumentor2 which sports a brand new website. These days I'm not convinced it's production ready but it does already look really promising.
我最近使用 Doxygen 为 PHP 生成文档。这是用于文档的开源工具，也支持其他语言。我想说这是一个很好的工具，它可以轻松生成文档和类图并且有很多可配置的功能。它适用于 Windows 以及 UNIX/LINUX
可以找到最新版本并在这里下载
I have recently used Doxygen for generating documentation for PHP.This is open-source tool for documentation and support other languages too.I would say this is a good tool and it easily generate documentation as well as class diagrams and have lots of configurable features.It is available for Windows as well as UNIX/LINUX
Can Find the latest release and DOWNLOAD Here
为什么要修复没有损坏的东西？ PHPDoc 工作得很好，实际上不需要任何其他东西。他们并不是试图创新，只是为了帮助创建文档。他们做到了，非常好。
Why fix something that isn't broken? PHPDoc works great, doesn't need anything else really. They're not trying to innovate, just to help create documentation. Which they did, very well.
我在使用 phpDocumentor 时遇到了几个问题。其中之一是 xml 导出。经过几次尝试修复代码后，我决定寻找替代方案。
我发现并喜欢的是：Rarangi
https://bitbucket.org/laurentj/rarangi/wiki/Home
有趣的事情它将信息保存在 mysql 数据库中，您可以制作自己的自定义报告。
I had several problems with phpDocumentor. One of them was the xml export. After a few attempts to fix the code I decided to look for an alternative.
What I found and liked was: Rarangi
https://bitbucket.org/laurentj/rarangi/wiki/Home
The interesting thing about it was that it saves the information in a mysql db and you can make your own custom reports.
phpDocumentor v3（具有适当的 PHP 7 支持）目前是 alpha 版本，非常接近稳定版本。问题是他们没有很多人在做这件事，所以开发很慢。
我已经在我的 Symfony 项目之一上测试了最新的 alpha，它的工作效果还不错，尽管它缺少一些功能并且有一些错误。当然，他们都被举报了。
https://github.com/phpDocumentor/phpDocumentor/releases
更新：
phpDocumentor v3 (with proper PHP 7 support) is currently alpha, getting real close to a stable release. The problem is that they don't have a lot of people working on it, so development is slow.
I've tested the latest alpha on one of my Symfony projects and it does the job okay, although it's missing some features and has a couple of bugs. They were all reported, of course.
https://github.com/phpDocumentor/phpDocumentor/releases
Update: phpDocumentor v3 just went beta. Check releases.