كيف تعرّف علاقات Eloquent؟

Question

Accepted Answer

**علاقات Eloquent** تصمّم كيفية ارتباط جداول قاعدة البيانات، وتُعرّف كطرق على النماذج. يدعم Laravel جميع أنواع العلاقات الشائعة — one-to-many، many-to-many، one-to-one، وغيرها — مما يوفر لك وصولاً أنيقاً وموجهاً للكائنات إلى البيانات ذات الصلة.

## One-to-many (hasMany / belongsTo)

```php
class User extends Model {
    public function posts() {              // a user HAS MANY posts
        return $this->hasMany(Post::class);
    }
}
class Post extends Model {
    public function author() {              // a post BELONGS TO a user (inverse)
        return $this->belongsTo(User::class);
    }
}

// access related data as properties (lazy-loaded)
$user->posts;          // a Collection of the user's Posts
$post->author;          // the Post's User
$user->posts()->where('published', true)->get();   // query the relationship
```

أكثر العلاقات شيوعاً: الوالد `hasMany` أطفال، وكل طفل `belongsTo` الوالد. الوصول إلى العلاقة كخاصية يرجع النموذج (النماذج) ذات الصلة.

## Many-to-many (belongsToMany)

```php
class Post extends Model {
    public function tags() {                // posts and tags — many-to-many
        return $this->belongsToMany(Tag::class);   // uses a pivot table (post_tag)
    }
}
$post->tags;                    // the post's tags
$post->tags()->attach($tagId);   // add an association
$post->tags()->detach($tagId);   // remove
$post->tags()->sync([1, 2, 3]);  // set exactly these
```

**Many-to-many** تستخدم جدول pivot (يُدار تلقائياً)، مع `attach`/`detach`/`sync` لإدارة الارتباطات.

## أنواع العلاقات الأخرى

```php
$this->hasOne(Profile::class);          // one-to-one
$this->hasManyThrough(...);              // has-many through an intermediate model
$this->morphMany(Comment::class, 'commentable');   // POLYMORPHIC (comments on posts OR videos)
```

## التحميل المسبق (تجنب N+1!)

```php
// ❌ N+1: a query per post to get each author
$posts = Post::all();
foreach ($posts as $post) { echo $post->author->name; }

// ✅ eager load with with() — fetches authors in ONE extra query
$posts = Post::with('author')->get();
```

استخدم `with()` لـ **تحميل مسبق** للعلاقات ومنع مشكلة استعلام N+1.

## لماذا يهم

علاقات Eloquent ضرورية للعمل مع البيانات الارتباطية في Laravel — تقريباً كل تطبيق يحتوي على كيانات مرتبطة (المستخدمون والمنشورات، المنشورات والتصنيفات، الطلبيات والعناصر)، لذا فهم كيفية تعريف واستخدام العلاقات هو معرفة أساسية يومية.

معرفة أنواع العلاقات ومتى تستخدم كل نوع — **`hasMany`/`belongsTo`** للعلاقات one-to-many (الأكثر شيوعاً)، **`belongsToMany`** للعلاقات many-to-many (مع جدول pivot و `attach`/`detach`/`sync`)، `hasOne` للعلاقات one-to-one، والعلاقات polymorphic للارتباطات المرنة — ضروري لنمذجة أي بيانات غير تافهة وهي واحدة من أقوى وأرق ميزات Eloquent.

العلاقات توفر لك وصولاً بديهياً وموجهاً للكائنات إلى البيانات ذات الصلة (`$user->posts`، `$post->author`) دون كتابة joins يدويًا، وهذا فائدة إنتاجية كبيرة.

بشكل حاسم، فهم **التحميل المسبق مع `with()`** لمنع **مشكلة استعلام N+1** (حيث يؤدي الوصول إلى العلاقات في حلقة إلى استعلام واحد لكل سجل — مشكلة أداء خطيرة) أمر ضروري، لأن العلاقات تجعل من السهل إدخال مشاكل N+1.

إتقان علاقات Eloquent — تعريفها، الوصول إلى البيانات ذات الصلة، والتحميل المسبق لتجنب N+1 — معرفة أساسية متكررة الاستخدام تدعم نمذجة البيانات الفعّالة والأداء في تطبيقات Laravel.