So verarbeiten Sie benutzerdefinierte S/DQL-Abfragen auf verschiedenen Datenbankmodulen mit DoctrineExpression

Beim Aufbau robuster Symfony-Projekte kommt es oft zu einem Punkt, an dem einfache Entity-Repository-Methoden wie findBy() nicht mehr ausreichen. Für mich war dieser Punkt erreicht und ich griff auf die Leistungsfähigkeit benutzerdefinierter DQL-Abfragen zurück, um komplexere Datenabrufanforderungen zu bewältigen. Damals verwendete ich MySQL als meine Standarddatenbank. Alles funktionierte perfekt, bis ich mein Projekt in einen Container umwandelte und mich entschied, aus Gründen der Leistung und Funktionsflexibilität auf PostgreSQL umzusteigen.

Aber oh nein! Meine DQL-Abfragen begannen sofort, Fehler auszulösen ?‍?. Was ist schief gelaufen? Meine benutzerdefinierte DQL-Syntax war perfekt auf die Besonderheiten und Funktionen von MySQL zugeschnitten, war jedoch nicht mit PostgreSQL kompatibel. Die Wahl fiel nun zwischen zwei anspruchsvollen Wegen:

Option 1: Kehren Sie zur Sicherheit zu MySQL zurück.

Aber was wäre, wenn ich das Projekt mit einem Entwickler teilen wollte, der PostgreSQL bevorzugt?

Option 2: Meine DQL neu schreiben, um PostgreSQL zu unterstützen.

Aber was wäre, wenn ich später wieder zu MySQL wechseln müsste? Oder was wäre, wenn ich ein Tool verwenden würde, das nur MySQL unterstützt?

Die Wahl zwischen diesen Optionen war nicht einfach – beide Optionen könnten mich an eine einzige Datenbankumgebung binden, was die Flexibilität bei zukünftigen technischen Entscheidungen einschränkt. Deshalb habe ich mich für einen anderen Ansatz entschieden und eine Lösung entwickelt, um datenbankspezifische Abfragen dynamisch und auf saubere, wiederverwendbare Weise zu verarbeiten.

---

Einführung in DoctrineExpression

DoctrineExpression ist eine PHP-Bibliothek, die entwickelt wurde, um plattformübergreifende, datenbankunabhängige DQL- und SQL-Abfragen in Symfony oder jedem Projekt zu ermöglichen, das Doctrine verwendet. Mit DoctrineExpression können Sie eine benutzerdefinierte Syntax für jede Datenbankplattform (MySQL, PostgreSQL, SQLite usw.) definieren und den richtigen Ausdruck basierend auf dem aktuellen Datenbanktreiber auswählen. Es funktioniert so:

1. Mehrere Ausdrücke definieren: Schreiben Sie eine unterschiedliche Syntax für jeden Datenbanktreiber und geben Sie einzigartige Abfragen an, die den Funktionen und Besonderheiten jeder Plattform entsprechen.
2. Automatische Treibererkennung: DoctrineExpression überprüft die verwendete Doctrine-Plattform und wendet dann automatisch die richtige Syntax für MySQL, PostgreSQL oder jede andere unterstützte Datenbank an.
3. Zukunftssichere Flexibilität: Indem DoctrineExpression Ihnen einen einfachen Datenbankwechsel ermöglicht, macht es Ihren Code zukunftssicher und stellt sicher, dass Sie mehrere Datenbanken ohne umfangreiche Umschreibungen unterstützen können.

Jetzt habe ich mit DoctrineExpression die Flexibilität, entweder MySQL oder PostgreSQL (oder sogar SQLite) zu verwenden und so meinen Code sauber und wartbar zu halten. Ich kann die Plattform basierend auf Projektanforderungen, Teampräferenzen oder Leistungsüberlegungen wechseln, ohne mir Gedanken über die Umgestaltung jeder benutzerdefinierten Abfrage machen zu müssen.

Wie DoctrineExpression das Problem löst

Sehen wir uns ein einfaches Beispiel an, bei dem wir Benutzer abrufen müssen, die sich innerhalb der letzten 24 Stunden registriert haben. Dies wird in MySQL und PostgreSQL oft unterschiedlich gehandhabt.

---

Ohne LehreAusdruck

1. MySQL: Verwendet DATE_SUB(NOW(), INTERVAL 1 DAY), um Datensätze innerhalb der letzten 24 Stunden zu finden.
2. PostgreSQL: Verwendet NOW() - INTERVAL '1 Tag' für dieselbe Abfrage.

So können Sie diese separat ohne DoctrineExpression schreiben:

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

Wenn Sie PostgreSQL verwenden würden, würden Sie in diesem Format schreiben:

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

Wenn Sie die Datenbank wechseln, müssen Sie diesen Code ändern, was unpraktisch und fehleranfällig ist.

---

Mit DoctrineExpression

Mit DoctrineExpression definieren Sie beide Syntaxen und überlassen den Rest der Bibliothek:

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();

Jetzt überprüft DoctrineExpression die verwendete Datenbankplattform und fügt dynamisch die richtige Syntax für die aktuelle Umgebung ein. Es spielt keine Rolle mehr, dass Sie MySQL oder PostgreSQL verwenden, es wählt den richtigen Ausdruck aus, sodass Sie Ihre Abfragen nicht jedes Mal ändern müssen, wenn Sie die Plattform wechseln, und es entfällt auch die Regel, if-else wiederholt zu verwenden

Abschließend:

DoctrineExpression spart Zeit und Mühe, indem es Ihnen ermöglicht, verschiedene Datenbanken zu verwenden, ohne Ihre Abfragen neu schreiben zu müssen. Dies ist besonders nützlich bei Containerprojekten oder Projekten mit mehreren Umgebungen, bei denen Sie eine benutzerdefinierte Syntax verwenden müssen, sich die Datenbankeinstellungen jedoch je nach Bereitstellungsanforderungen oder Vertrautheit des Teams ändern können. Probieren Sie es aus und lassen Sie mich wissen, wie es bei Ihnen funktioniert!

Schauen Sie sich DoctrineExpression auf GitHub an

Viel Spaß beim Codieren!

Das obige ist der detaillierte Inhalt vonSo verarbeiten Sie benutzerdefinierte S/DQL-Abfragen auf verschiedenen Datenbankmodulen mit DoctrineExpression. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!