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

Question

• 附录
• 学说2注释

你能告诉我一个比另一个更好的理由吗？

这是我现在的名单：

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

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

Answer 1

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

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

Answer 2

物有所值...

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

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

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