在使用 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 TestsdataDqlModelBook; // 假設你的 Book 實體類位于此命名空間use EDTDqlQueryingConditionFactoriesDqlConditionFactory;use EDTDqlQueryingUtilitiesQueryBuilderPreparer;use EDTDqlQueryingJoinFinder; //這個類用于自動查找關聯關系/** @var DoctrineORMEntityManager $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 將是一個非常值得推薦的庫。
