PHP注释：附录或学说注释？

Question

• Addendum
• Doctrine 2 Annotations

你能告诉我一个人比另一个人好吗？

这是我现在的名单：

• 附录是一个专门用于此项目的项目
• 附录似乎具有更多功能
• 附录API 似乎更易于使用
• 学说有更多的支持和更多的人参与
• Doctrine似乎是一个更 alive
的项目
• Doctrine完全兼容PHP 5.3，而Addendum似乎试图兼容（参见主页）
• 可以轻松缓存Doctrine Annotations

这个决定并不容易......

Answer 1

我想我宁愿使用Doctrine的组件：

• 我从来没有听说过附录 - 虽然我听说过很多关于Doctrine （并且多次使用过它）
  • 这意味着更多社区和对Doctrine的支持
• Doctrine被一些大型框架（symfony;可以很容易地与Zend Framework集成）使用
  • 这意味着您已经使用Doctrine的机会更高;并找到熟悉其语法的开发人员
• 对你来说可能不那么重要，但是Doctrine团队的一些人已经做了一些工作来将Annotations集成到PHP中
  • 有一个RFC：Request for Comments: Class Metadata
  • 目前，它似乎不会被整合到PHP中，但这意味着Doctrine的团队已完成的工作，这表明他们的解决方案有一些想法

Answer 2

为了它的价值......

我已经使用了一年的附录，我发现它非常容易使用。它对PHP Reflection API的扩展是无缝的，它支持比Doctrine Annotations组件更多的用例。

它缺少命名空间支持，但我可以修补AnnotationMatcher类，因此它接受了命名空间类（没有从docblock标签获取错误匹配），它就像魅力一样。

Doctrine的注释考虑了PHP 5.3使用语句。这是附录中没有做到的唯一事情，IMO实施起来并不是那么简单。