学说：QueryBuilder 与 createQuery？

Posted 2023-02-16

【中文标题】学说：QueryBuilder 与 createQuery？

【英文标题】：doctrine: QueryBuilder vs createQuery?

【发布时间】：2011-02-10 08:10:26

【问题描述】：

在 Doctrine 中，您可以通过 2 种方式创建 DQL：

EntityManager::createQuery:

$query = $em->createQuery('SELECT u FROM MyProject\Model\User u WHERE u.id = ?1');

查询构建器：

$qb->add('select', 'u')
   ->add('from', 'User u')
   ->add('where', 'u.id = ?1')
   ->add('orderBy', 'u.name ASC');

我想知道有什么区别，我应该使用哪个？

【参考方案1】：

使用查询生成器时可能更容易进行单元测试。假设您有一个存储库，它根据复杂的条件列表查询一些数据。并且您要确保如果将特定条件传递到存储库中，则会将其他一些条件添加到查询中。对于 DQL，您有两种选择：

1) 使用fixture 并测试与DB 的真实交互。我觉得这有点麻烦和不团结。

2) 检查生成的 DQL 代码。这会使您的测试过于脆弱。

使用 QueryBuilder，您可以将其替换为 mock，并验证是否调用了带有所需参数的“andWhere”方法。当然，如果您的查询很简单且不依赖于任何参数，则此类注意事项不适用。

【参考方案2】：

主要区别在于调用方法的开销。您的第一个代码示例 (createQuery) 只是为了简单起见进行了一次方法调用，而 queryBuilder 进行了 4 次调用。在一切结束时，它们归结为一个必须执行的字符串，第一个示例是您给它的字符串，并且另一个你正在使用多个链式方法调用来构建它。

如果您正在寻找使用其中一个而不是另一个的理由，那就是风格问题，以及什么看起来更具可读性。对我来说，我大部分时间都喜欢 queryBuider，它为查询提供了明确定义的部分。此外，在过去，它可以让您在需要时更轻松地添加条件逻辑。

【讨论】：

一个小观察 - 我想说几乎任何时间花在任何数量的 php 函数调用上，与 SQLing 相关，总是比花在交谈、等待和拉动来自数据库的实际结果（更不用说在 ORM 的情况下为它们补水了）。

【参考方案3】：

他们有不同的目的：

当您了解完整查询时，DQL 更易于使用。 当您必须根据某些条件、循环等构建查询时，查询构建器会更加智能。

【参考方案4】：

查询生成器只是，可以说，创建查询的接口......它应该更舒服，它不仅有 add() 方法，而且还有 where() 和 Where() 等方法， from( ) 等。但最后，它只是像您在 createQuery() 方法中使用的那样组成查询。

查询构建器的更高级使用示例：

$em->createQueryBuilder()
            ->from('Project\Entities\Item', 'i')
            ->select("i, e")
            ->join("i.entity", 'e')
            ->where("i.lang = :lang AND e.album = :album")
            ->setParameter('lang', $lang)
            ->setParameter('album', $album);

【讨论】：

你可以添加 ->setParameters(array('x' => 'y', 'z' => 'w', ...))

【参考方案5】：

DQL 更易于阅读，因为它与 SQL 非常相似。如果您不需要根据一组参数更改查询，这可能是最佳选择。

Query Builder 是一个用于构造查询的 api，因此如果您需要像迭代一组参数或过滤器一样动态地构建查询，它会更容易。您不需要执行任何字符串操作来构建查询，例如连接、拆分或其他。

【讨论】：

但是在第一种情况下解析 DQL 字符串没有开销吗？还是生成器也会生成相同的 DQL 字符串？

是的，QueryBuilder 会为您创建 DQL 字符串。之后，无论如何都会解析 DQL。