ما هو محرّك الاستعلامات (Query Builder) وما علاقته بـ Eloquent؟

Question

Accepted Answer

**محرّك الاستعلامات (Query Builder)** في Laravel هو واجهة سلسة وقابلة للربط لبناء وتنفيذ استعلامات قاعدة البيانات دون كتابة SQL خام. **Eloquent مبني فوق Query Builder** — نماذج Eloquent تستخدمه تحت الغطاء، واستعلامات Eloquent يمكنها استخدام جميع طرق Query Builder.

## محرّك الاستعلامات (مستوى قاعدة البيانات، عبر واجهة DB)

```php
use Illuminate\Support\Facades\DB;

DB::table('users')
    ->where('active', true)
    ->where('age', '>', 18)
    ->orderBy('name')
    ->limit(10)
    ->get();                          // returns generic objects (not models)

DB::table('users')->where('id', 1)->update(['name' => 'X']);
DB::table('users')->insert(['name' => 'Ann']);
```

محرّك الاستعلامات يعمل مباشرة مع الجداول (يُرجع كائنات عادية، وليس نماذج Eloquent). إنه قابل للربط و**يستخدم تلقائياً ربط المعاملات** — مما يمنع حقن SQL.

## Eloquent يستخدم نفس الطرق السلسة

```php
// Eloquent queries support ALL Query Builder methods (it's built on top)
User::where('active', true)
    ->where('age', '>', 18)
    ->orderBy('name')
    ->get();                          // returns User MODELS (with relationships, etc.)
```

عندما تربط طرقاً على نموذج Eloquent، فأنت تستخدم Query Builder تحتها — لكنك تحصل على **نماذج** (مع العلاقات والمُعدِّلات والطرق) بدلاً من الكائنات العادية.

## الاستعلامات المتقدمة (كلاهما يدعمها)

```php
DB::table('orders')
    ->join('users', 'orders.user_id', '=', 'users.id')   // joins
    ->select('orders.*', 'users.name')
    ->where('orders.total', '>', 100)
    ->groupBy('users.id')
    ->havingRaw('SUM(orders.total) > 1000')
    ->get();

User::where('role', 'admin')
    ->orWhere('role', 'editor')
    ->whereIn('status', ['active', 'pending'])
    ->get();
```

كلاهما يدعم الوصلات (joins) والدوال الإجمالية والاستعلامات الفرعية والشروط المعقدة.

## متى تستخدم أيهما

```text
Eloquent (Model::...) → the default — get models with relationships/accessors/methods.
                        Best for most application logic.
Query Builder (DB::table) → when you want lightweight queries without model overhead,
                            complex reporting/aggregations, or to avoid loading models.
```

## لماذا يعتبر مهماً

فهم محرّك الاستعلامات وعلاقته بـ Eloquent مهم للعمل بفعالية مع قواعد البيانات في Laravel واختيار الأداة المناسبة لكل موقف.

الفكرة الأساسية هي أن **Eloquent مبني على Query Builder** — لذا فإن الطرق السلسة والقابلة للربط التي تستخدمها على نماذج Eloquent (`where`، `orderBy`، `join`، إلخ) هي من Query Builder، مما يعني أن تعلم أحدهما يعلمك كليهما.

محرّك الاستعلامات يوفر طريقة نظيفة وآمنة من حقن SQL (عبر ربط المعاملات التلقائي) لبناء الاستعلامات دون كتابة SQL خام، و Eloquent يضيف وظائف النموذج (العلاقات والمُعدِّلات والطرق) فوقها.

معرفة **متى تستخدم أيهما** هي المهارة العملية: **Eloquent** لمعظم منطق التطبيق (تحصل على كائنات نموذج غنية مع العلاقات والسلوك)، و**Query Builder مباشرة** (`DB::table`) للاستعلامات الخفيفة بدون حمل النموذج، الاستعلامات المعقدة للتقارير/الدوال الإجمالية، أو عندما لا تحتاج إلى نماذج كاملة — وهذا يمكن أن يكون أكثر كفاءة في حالات معينة.

كلاهما يتعامل بأمان مع الاستعلامات المعقدة (الوصلات والدوال الإجمالية والاستعلامات الفرعية) مع نفس واجهة برمجية سلسة.

فهم Query Builder وكيف يبني Eloquent عليه وربط المعاملات الآمن المشترك (منع حقن SQL) والاختيار بينهما معرفة مهمة لكتابة كود قاعدة بيانات فعال وآمن في Laravel، لأن الوصول إلى قاعدة البيانات أساسي في معظم التطبيقات واختيار المستوى المناسب (Eloquent الغني بالنماذج مقابل Query Builder الخفيف) يؤثر على كل من الوضوح والأداء.