DoctrineExpression을 사용하여 다른 데이터베이스 엔진에서 사용자 정의 S/DQL 쿼리를 처리하는 방법

강력한 Symfony 프로젝트를 구축하는 과정에서 findBy()와 같은 간단한 엔터티 저장소 메서드로는 더 이상 충분하지 않은 지점이 종종 발생합니다. 저는 그 시점에 이르렀고 더 복잡한 데이터 검색 요구 사항을 처리할 수 있는 사용자 정의 DQL 쿼리의 기능을 사용하게 되었습니다. 당시 저는 MySQL을 기본 데이터베이스로 사용하고 있었습니다. 프로젝트를 컨테이너화하고 성능과 기능 유연성을 위해 PostgreSQL으로 전환하기 전까지 모든 것이 완벽하게 작동했습니다.

그런데, 아뇨! 내 DQL 쿼리에 즉시 오류가 발생하기 시작했습니다 ?‍?. 무엇이 잘못되었나요? 내 사용자 정의 DQL 구문은 MySQL의 특징과 기능에 맞게 완벽하게 제작되었지만 PostgreSQL과 호환되지 않았습니다. 이제 선택은 두 가지 어려운 길 사이에 있었습니다.

옵션 1: MySQL로 돌아가서 안전하게 유지하세요.

하지만 PostgreSQL을 선호하는 개발자와 프로젝트를 공유하고 싶다면 어떻게 해야 할까요?

옵션 2: PostgreSQL을 지원하도록 DQL을 다시 작성합니다.

하지만 나중에 MySQL로 다시 전환해야 한다면 어떻게 해야 할까요? 아니면 MySQL만 지원하는 도구를 사용했다면 어떻게 될까요?

둘 중 하나를 선택하는 것은 쉽지 않았습니다. 두 옵션 모두 단일 데이터베이스 환경에 갇히게 되어 향후 기술 선택의 유연성이 제한될 수 있습니다. 그래서 저는 다른 접근 방식을 취하기로 결정하고, 깨끗하고 재사용 가능한 방식으로 데이터베이스별 쿼리를 동적으로 처리하는 솔루션을 만들었습니다.

---

DoctrineExpression 소개

DoctrineExpression은 Symfony 또는 교리를 활용하는 모든 프로젝트에서 크로스 플랫폼, 데이터베이스에 구애받지 않는 DQL 및 SQL 쿼리를 활성화하도록 설계된 PHP 라이브러리입니다. 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 사용

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 중국어 웹사이트의 기타 관련 기사를 참조하세요!