Doctrine ORM: تصفية استعلامات ManyToMany ذات العلامات المتعددة

إتقان التصفية القائمة على العلامات في استعلامات ORM المذهبية

تخيل أنك تقوم بإنشاء ميزة بحث عن الأسعار حيث يمكن للمستخدمين تصفية النتائج باستخدام علامات متعددة. 🏷️ في البداية، يبدو الأمر واضحًا - تكتب استعلامًا، وتنضم إلى الجداول، وتتوقع النتائج. ومع ذلك، عند إضافة علامات متعددة، يبدأ الاستعلام بإرجاع نتائج فارغة أو يتصرف بشكل غير متوقع.

يعد هذا تحديًا شائعًا يواجهه المطورون في Doctrine ORM عند التعامل مع علاقات ManyToMany. تتطلب التصفية حسب علامات متعددة الدقة، خاصة عند الجمع بين شروط WHERE والعمليات المنطقية مثل AND أو IN. بدون النهج الصحيح، قد تجد صعوبة في الحصول على نتائج متسقة.

في مشروع حديث، واجهت هذه المشكلة بالضبط. يحتاج المستخدم إلى البحث في علامات الاقتباس التي تحتوي على جميع العلامات المحددة، وليس علامة واحدة فقط. لقد جربت شروط AND وعبارات IN()، لكن منطق الاستعلام لم يعمل بشكل جيد مع منشئ الاستعلامات في Doctrine. لقد تركتني أخدش رأسي حتى وجدت الحل. 💡

في هذه المقالة، سأرشدك إلى كيفية تضييق نطاق الاستعلامات في علاقة ManyToMany باستخدام Doctrine ORM. سواء كنت تقوم بالتصفية حسب علامات متعددة باستخدام منطق "AND" أو تعمل باستخدام منطق استعلام مخصص، فسوف أشارك مثالًا عمليًا واضحًا لمساعدتك في تنفيذ ذلك بفعالية. دعونا نتعمق! 🚀

كيفية تصفية الاقتباسات في Doctrine ORM باستخدام العلامات

في الخلفية، تصفية الاقتباسات حسب علامات متعددة يتطلب بناء استعلام دقيق عند العمل مع علاقات ManyToMany. يبدأ البرنامج النصي بمنشئ استعلام تم إنشاؤه باستخدام طريقة "createQueryBuilder". هذا هو المكان الذي يتم فيه تحديد الكيان الأساسي ("عرض الأسعار"). لتصفية علامات الاقتباس بناءً على العلامات، يقوم أمر `leftJoin` بربط كيان `العلامات` بجدول علامات الاقتباس، مما يسمح لنا بتطبيق الشروط على العلامات ذات الصلة. إذا طلب المستخدم التصفية باستخدام منطق OR، فإننا نستخدم جملة `IN()` لمطابقة علامات الاقتباس مع أي من العلامات المحددة.

However, in cases where quotes need to match all the provided tags (AND logic), the `expr()->andX()` method comes into play. This method lets us add multiple equality conditions using `expr()->ومع ذلك، في الحالات التي تحتاج فيها علامات الاقتباس إلى مطابقة جميع العلامات المتوفرة (منطق AND)، يتم تفعيل الطريقة `expr()->andX()`. تتيح لنا هذه الطريقة إضافة شروط مساواة متعددة باستخدام `expr()->eq()`، حيث يجب أن يتطابق كل معرف علامة مع علامة ذات صلة. يضمن الاستعلام إرجاع علامات الاقتباس التي تحتوي على كافة العلامات المحددة فقط. يعمل هذا الأسلوب على حل المشكلة الشائعة حيث لا تؤدي التصفية حسب العلامات المتعددة إلى ظهور أي نتائج بسبب إنشاء استعلام غير صحيح.

في الواجهة الأمامية، ترسل وظيفة جلب JavaScript ديناميكيًا العلامات المحددة للمستخدم إلى الواجهة الخلفية. على سبيل المثال، إذا قام المستخدم بتحديد العلامات 88 و 306، فسيتم تضمين هذه المعرفات في طلب JSON. تقوم الواجهة الخلفية بمعالجة هذا الطلب، وإنشاء الاستعلام بالشروط المناسبة، وإرجاع النتائج التي تمت تصفيتها. يضمن هذا التفاعل ثنائي الاتجاه تجربة مستخدم سلسة حيث يتم تحديث البحث ديناميكيًا بناءً على إدخال المستخدم. 🚀

لتحسين أداء الاستعلام، يمكن استخدام أوامر SQL مثل `GROUP BY` و`HAVING COUNT` مباشرةً لضمان تطابق العلامات بشكل صحيح. من خلال تجميع علامات الاقتباس وحساب العلامات المميزة المرتبطة بها، يقوم الاستعلام بتصفية أي علامات اقتباس لا تستوفي معايير عدد العلامات. بالإضافة إلى ذلك، فإن استخدام `setFirstResult` و`setMaxResults` يضمن ترقيم الصفحات بشكل صحيح، مما يحسن الأداء عند التعامل مع مجموعات البيانات الكبيرة. تعمل هذه الطريقة بشكل جيد في السيناريوهات التي يبحث فيها المستخدمون عن نتائج محددة تمت تصفيتها بين مجموعة كبيرة من علامات الاقتباس. 😊

// 1. Backend PHP solution to filter results using multiple tags in Doctrine ORM
$search = $request->request->all()['quote_search'];
$queryBuilder = $this->createQueryBuilder('q');
// Check if tag mode and tags are set
if ($search['tagMode'] != -1 && !empty($search['tags'])) {
    $queryBuilder->leftJoin('q.tags', 't');
    if ($search['tagMode'] == 1000) { // OR logic using IN()
        $queryBuilder->setParameter("tags", $search['tags']);
        $queryBuilder->andWhere("t.id IN (:tags)");
    } else if ($search['tagMode'] == 2000) { // AND logic for multiple tags
        $andExpr = $queryBuilder->expr()->andX();
        foreach ($search['tags'] as $tagId) {
            $andExpr->add($queryBuilder->expr()->eq("t.id", $tagId));
        }
        $queryBuilder->andWhere($andExpr);
    }
}
// Set pagination and ordering
$queryBuilder
    ->orderBy('q.id', 'ASC')
    ->setFirstResult($page * $limit)
    ->setMaxResults($limit);
$quotes = $queryBuilder->getQuery()->getResult();

SELECT q.id, q.content
FROM quote q
JOIN quote_tag qt ON q.id = qt.quote_id
JOIN tag t ON t.id = qt.tag_id
WHERE t.id IN (88, 306)
GROUP BY q.id
HAVING COUNT(DISTINCT t.id) = 2
ORDER BY q.id ASC
LIMIT 10 OFFSET 0;

// Assume user selects tags and submits the form
const selectedTags = [88, 306];
const tagMode = 2000; // AND mode
const data = {
    quote_search: {
        tagMode: tagMode,
        tags: selectedTags
    }
};
// Send tags to the backend via fetch
fetch('/quotes/filter', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

use PHPUnit\Framework\TestCase;
use Doctrine\ORM\EntityManager;
class QuoteRepositoryTest extends TestCase {
    public function testFilterQuotesByMultipleTags() {
        $entityManager = $this->createMock(EntityManager::class);
        $repo = new QuoteRepository($entityManager);
        $search = [
            'tagMode' => 2000,
            'tags' => [88, 306]
        ];
        $quotes = $repo->filterByTags($search, 0, 10);
        $this->assertNotEmpty($quotes);
        foreach ($quotes as $quote) {
            $this->assertContains(88, $quote->getTagIds());
            $this->assertContains(306, $quote->getTagIds());
        }
    }
}

عقيدة ORM: أوامر ومفاهيم لتصفية استعلامات ManyToMany

تحسين Doctrine ORM للاستعلامات المعقدة القائمة على العلامات

عند العمل مع علاقات ManyToMany في Doctrine ORM، الجانب الذي تم التغاضي عنه هو تحسين الاستعلام. على الرغم من أن عوامل التصفية الأساسية التي تستخدم `AND` أو `IN` تكون كافية في مجموعات البيانات الصغيرة، إلا أن الأداء يمكن أن يتدهور مع نمو قاعدة البيانات. يصبح تحسين الاستعلامات لإرجاع نتائج دقيقة بكفاءة أمرًا بالغ الأهمية. على سبيل المثال، عند تصفية علامات الاقتباس حسب علامات متعددة، فإن إضافة الفهرسة في الجداول ذات الصلة (على سبيل المثال، `quote_tag` و`tag`) يمكن أن يقلل بشكل كبير من وقت تنفيذ الاستعلام. بدون الفهرسة المناسبة، تقوم قاعدة البيانات بإجراء عمليات فحص كاملة، وهي مكلفة من حيث الموارد.

Another crucial optimization is reducing unnecessary joins. For example, when you only need quote IDs that match all selected tags, you can retrieve IDs with a single query using `GROUP BY` and `HAVING COUNT`. This avoids fetching entire rows and minimizes memory usage. Additionally, the query builder’s `expr()->هناك تحسين حاسم آخر وهو تقليل عمليات الانضمام غير الضرورية. على سبيل المثال، عندما تحتاج فقط إلى معرفات عروض الأسعار التي تطابق جميع العلامات المحددة، يمكنك استرداد المعرفات باستخدام استعلام واحد باستخدام `GROUP BY` و`HAVING COUNT`. يؤدي ذلك إلى تجنب جلب صفوف بأكملها وتقليل استخدام الذاكرة. بالإضافة إلى ذلك، يمكن استبدال أسلوب `expr()->andX()` الخاص بمنشئ الاستعلامات بـ SQL الخام المحسّن للتصفية واسعة النطاق. يمكن أن يؤدي استخدام SQL الخام في بعض الأحيان إلى تجاوز حمل Doctrine أثناء تحقيق نفس الوظيفة.

تعد آلية التخزين المؤقت الخاصة بـ Doctrine أداة أخرى لتحسين التصفية المستندة إلى العلامات. من خلال تمكين التخزين المؤقت للنتائج، تؤدي عمليات البحث المتكررة بشروط متطابقة إلى تجنب إعادة تنفيذ الاستعلام. يعد هذا مفيدًا بشكل خاص في السيناريوهات التي لا تتغير فيها البيانات بشكل متكرر. الجمع بين هذه الاستراتيجيات -الفهرسةوتحسين الاستعلام والتخزين المؤقت — يضمن أن تظل استعلامات ManyToMany لتصفية العلامات سريعة وقابلة للتطوير. يساعد التنفيذ الصحيح لهذه التقنيات المطورين على تجنب الاختناقات مع نمو التطبيق وقاعدة البيانات. 🚀