在使用 doctrine orm 进行数据库操作时，我们经常会遇到需要编写复杂 dql 查询的情况，尤其是在处理多表关联和复杂筛选条件时，手动编写 dql 查询语句不仅费时费力，而且容易出错。代码的可读性和可维护性也会因此降低。 想象一下，你需要查询所有作者出生在美国的书籍信息，这需要在 dql 中进行两次关联查询，并编写相应的 where 子句。 如果你的查询条件更加复杂，例如需要同时考虑多个属性和排序条件，那么编写和维护 dql 查询将变得更加困难。
传统的做法需要我们手动编写类似这样的 DQL 查询：
SELECT b FROM Book bLEFT JOIN b.author aLEFT JOIN a.birth biWHERE bi.country = 'USA'
这对于简单的查询还算可以接受，但对于复杂的查询，这种方式就显得笨拙且容易出错。 更糟糕的是，如果你的查询条件需要动态生成，那么这种手动编写的方式将变得几乎不可维护。
demos-europe/edt-dql 库为我们提供了一种优雅的解决方案。它允许我们以一种更声明式的方式构建 DQL 查询，无需手动编写复杂的 JOIN 和 WHERE 子句。
让我们来看一下如何使用 demos-europe/edt-dql 来完成同样的查询：
首先，通过 Composer 安装该库：
composer require demos-europe/edt-dql
然后，我们可以使用以下代码构建我们的查询：
use Tests\data\DqlModel\Book; // 假设你的 Book 实体类位于此命名空间use EDT\DqlQuerying\ConditionFactories\DqlConditionFactory;use EDT\DqlQuerying\Utilities\QueryBuilderPreparer;use EDT\DqlQuerying\JoinFinder; //这个类用于自动查找关联关系/** @var \Doctrine\ORM\EntityManager $entityManager */$entityManager = $this->getEntityManager();$conditionFactory = new DqlConditionFactory();$metadataFactory = $entityManager->getMetadataFactory();$builderPreparer = new QueryBuilderPreparer(Book::class, $metadataFactory, new JoinFinder($metadataFactory));$builderPreparer->setWhereExpressions([ $conditionFactory->propertyHasValue('USA', 'authors', 'birth', 'country'),]);$queryBuilder = $entityManager->createQueryBuilder();$builderPreparer->fillQueryBuilder($queryBuilder);$query = $queryBuilder->getQuery();$books = $query->getResult();这段代码通过 propertyHasValue 方法简洁地表达了我们的查询条件：作者（authors）的出生信息（birth）中的国家（country）等于 "USA"。 QueryBuilderPreparer 会自动处理 JOIN 语句的生成，从而简化了我们的代码。 这比手动编写 DQL 查询更加清晰易懂，也更容易维护。
demos-europe/edt-dql 库还支持更复杂的条件组合、排序以及自定义条件的编写，从而满足各种复杂的查询需求。 它显著减少了编写和维护 DQL 查询的工作量，提高了代码的可读性和可维护性，并降低了出错的概率。 如果你经常使用 Doctrine ORM 进行数据库操作，那么 demos-europe/edt-dql 将是一个非常值得推荐的库。
