我在 Symfony 框架中使用 Doctrine 2 作为 ORM。对实体使用基于注释的映射，我将不得不编写大量代码（setter 和 getter、映射信息等）。使用 YAML/XML，我不必只写列定义和元数据。在 Doctrine 文档中，他们主要使用示例中的注释，很少使用 YAML 或 XML。
我应该使用 YAML/XML 还是注释？
对于注释，我可以在http://docs.doctrine-project.org/en/latest/reference/annotations-reference.html 找到每个注释的文档。不过，我在 YAML 或 XML 中找不到注释的等价物；如何将注释转换为等效的 YAML/XML 表达式？
【问题讨论】：
标签： symfony doctrine-orm
这基本上取决于偏好。
这是我的看法：
注释的优点：
yaml/xml 的优点
如果您更改数据库或域，您仍然必须以任何一种形式维护它们，因此从这个角度来看，在任何方向上都没有真正的优势。
从性能的角度来看，在生产中你应该使用学说的缓存来缓存映射，所以它们在这里也是相等的。
关于这个：“我将不得不编写大量代码、setter 和 getter、映射信息”：
Doctrine 需要私有/受保护的属性，因此您仍将编写 getter 和 setter。而且您仍将在另一个地方编写映射信息。
就我个人而言，我会使用注释，因为如果需要的话，查找示例和信息会容易得多。
【讨论】：
Also, having the config for all entities in one huge yaml/xml file is also a bit off-putting to me 我不知道你在说什么。通常，每个实体都有自己的 yaml/xml 文件。在大多数情况下（尤其是 YAML），它们甚至都不是很大。
使用注解有一个缺点。由于它们是在 cmets 上定义的（这很奇怪），因此您将无法使用预编译器（如 Zend Guard）或 some 字节码 php 缓存扩展来提高代码性能（some 其中剥离 cmets）。因为注释是唯一存在这种技术缺陷的规范，我不建议使用它。
另外，在 cmets 上写“功能性”的东西很奇怪。
XML 比 YAML 更冗长，但也更广为人知。 XML 的文档示例是所有选项中最差的。
YAML 比其他任何一种都更具可读性，但它也依赖于空间标识（有些人不喜欢）。 Symfony 默认使用 YAML 进行配置，因此许多使用 Symfony 的人选择使用 YAML 进行教义映射——这意味着 YAML 示例有很好的文档记录，并且那里有很多资源。
我个人更喜欢 YAML。我可以使用教义模式工具自动生成实体（这意味着我不必编写 getter/setter）。我还可以使用预编译器/字节码缓存选项，而不必担心我的 cmets 会被删除。
附加信息：
如果您使用的是 PHP 7.0 或更高版本，如果您使用注释，则永远无法在 php.ini 上设置 opcache.save_comments = 0。 PHP 有一种剥离 cmets 的本机方式，这会破坏您的应用程序。 Guilherme Blanco，Doctrine 最活跃的维护者之一，他开发了大多数项目（Doctrine，Symfony）使用的注释检索类has spoken out AGAINST comment annotations（如果你阅读了整个线程，你会发现他对此非常热情） .还有一些extensive discussion on the issues with comment annotations on Reddit，大多数人似乎都同意这是一个坏主意。
尽管如此，Symfony 的官方最佳实践书建议人们使用注释。因此，大多数 Symfony 包可能会使用注释作为它们的元数据格式。
【讨论】：
If you're using PHP 7.0 or higher, you can't ever set opcode.save_comments = 0 on php.ini if you're using annotations. 来源？
我认为这是个人喜好问题，我更喜欢注释。
我使用注解是因为如果您想了解某个字段的任何信息，那么您必须打开一个新文件并搜索您需要的规则。
找出这两种情况的最佳方法。然后你看看你喜欢什么。
【讨论】：