如何使用 DoctrineExpression 處理不同資料庫引擎上的自訂 S/DQL 查詢

在建構健壯的 Symfony 專案的過程中，常常會出現這樣的情況：簡單的實體儲存庫方法（如 findBy()）不再足夠。對我來說，這一點已經到來，我開始利用自訂 DQL 查詢的強大功能來處理更複雜的資料檢索需求。當時，我使用 MySQL 作為我的預設資料庫。一切都很完美，直到我將專案容器化並決定切換到 PostgreSQL 以獲得效能和功能靈活性。

但是，喔不！我的 DQL 查詢立即開始拋出錯誤？出了什麼問題？我的自訂 DQL 語法完美地針對 MySQL 的怪癖和功能而設計，但與 PostgreSQL 不相容。現在需要在兩條具有挑戰性的道路之間做出選擇：

選項 1：還原到 MySQL 以確保安全。

但是如果我想與喜歡 PostgreSQL 的開發人員分享該專案怎麼辦？

選項 2：重寫我的 DQL 支援 PostgreSQL。

但是，如果我稍後需要切換回 MySQL 怎麼辦？或者如果我使用只支援 MySQL 的工具呢？

在這些之間進行選擇並不容易——這兩個選項都可能將我鎖定在單一資料庫環境中，從而限制了未來技術選擇的靈活性。因此，我決定採取不同的方法並建立一個解決方案，以乾淨、可重複使用的方式動態處理特定於資料庫的查詢。

---

DoctrineExpression 簡介

DoctrineExpression 是一個 PHP 函式庫，旨在在 Symfony 或任何使用 Doctrine 的專案中啟用跨平台、與資料庫無關的 DQL 和 SQL 查詢。使用 DoctrineExpression，您可以為每個資料庫平台（MySQL、PostgreSQL、SQLite 等）定義自訂語法，它會根據目前資料庫驅動程式選擇正確的表達式。它的工作原理如下：

1. 定義多個表達式：為每個資料庫驅動程式編寫不同的語法，指定與每個平台的功能和怪癖相符的唯一查詢。
2. 自動驅動程式偵測：DoctrineExpression 檢查正在使用的 Doctrine 平台，然後自動為 MySQL、PostgreSQL 或任何其他支援的資料庫套用正確的語法。
3. 面向未來的靈活性：透過讓您輕鬆切換資料庫，DoctrineExpression 可以保證您的程式碼面向未來，確保您無需大量重寫即可支援多個資料庫。

現在，有了 DoctrineExpression，我可以靈活地使用 MySQL 或 PostgreSQL（甚至 SQLite），保持程式碼乾淨且可維護。我可以根據專案要求、團隊偏好或效能考量來切換平台，而不必擔心重構每個自訂查詢。

DoctrineExpression 如何解決這個問題

讓我們來看一個簡單的例子，我們需要檢索過去 24 小時內註冊的用戶。這在 MySQL 和 PostgreSQL 中通常有不同的處理方式。

---

無教義表達

1. MySQL：使用 DATE_SUB(NOW(), INTERVAL 1 DAY) 尋找過去 24 小時內的記錄。
2. PostgreSQL：對相同查詢使用 NOW() - INTERVAL '1 天'。

以下是在沒有 DoctrineExpression 的情況下單獨編寫這些內容的方法：

// MySQL Query
$mysqlQuery = $entityManager->createQuery(
    "SELECT u FROM App\Entity\User u WHERE u.registeredAt > DATE_SUB(NOW(), INTERVAL 1 DAY)"
);

如果你使用 PostgreSQL，你會這樣寫：

// PostgreSQL Query
$postgresQuery = $entityManager->createQuery(
    "SELECT u FROM App\Entity\User u WHERE u.registeredAt > NOW() - INTERVAL '1 day'"
);

如果切換資料庫，就需要修改這段程式碼，既不方便，又容易出錯。

---

與教義表達

使用 DoctrineExpression，您可以定義兩種語法並讓庫處理其餘部分：

use Ucscode\DoctrineExpression\DoctrineExpression;
use Ucscode\DoctrineExpression\DriverEnum;

// Create an expression instance with an EntityManager argument
$expression = new DoctrineExpression($entityManager);

// Registration S/DQL for varying database
$expression
    ->defineQuery(DriverEnum::PDO_MYSQL, function($entityManager) {
        return $entityManager->createQuery(
            "SELECT u FROM App\Entity\User u WHERE u.registeredAt > DATE_SUB(NOW(), INTERVAL 1 DAY)"
        );
    })
    ->defineQuery(DriverEnum::PDO_PGSQL, function($entityManager) {
        return $entityManager->createQuery(
            "SELECT u FROM App\Entity\User u WHERE u.registeredAt > NOW() - INTERVAL '1 day'"
        );
    });

// Fet any of the defined query based on the active doctine driver being used
$query = $expression->getCompatibleResult();

現在，DoctrineExpression 檢查正在使用的資料庫平台，並動態插入當前環境的正確語法。無論你使用 MySQL 還是 PostgreSQL，它都會選擇正確的表達式，讓你不必每次切換平台時都修改查詢，並且還刪除了重複使用 if-else 的樣板

綜上所述：

DoctrineExpression 讓您可以使用不同的資料庫而無需重寫查詢，從而節省時間和精力。它在容器化或多環境專案中特別有用，您需要在這些專案中使用自訂語法，但資料庫首選項可能會根據部署需求或團隊熟悉程度而變更。嘗試一下，讓我知道它對你有什麼作用！

查看 GitHub 上的 DoctrineExpression

編碼愉快！

以上是如何使用 DoctrineExpression 處理不同資料庫引擎上的自訂 S/DQL 查詢的詳細內容。更多資訊請關注PHP中文網其他相關文章！