علاقات Eloquent

// جدول users
id | name | email | created_at | updated_at

// جدول profiles
id | user_id | bio | website | avatar | created_at | updated_at

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    // المستخدم لديه ملف تعريف واحد
    public function profile()
    {
        return $this->hasOne(Profile::class);
    }
}

class Profile extends Model
{
    // ملف التعريف ينتمي إلى المستخدم
    public function user()
    {
        return $this->belongsTo(User::class);
    }
}

// الوصول إلى البيانات ذات الصلة
$user = User::find(1);
$profile = $user->profile;  // يُرجع نموذج Profile

echo $profile->bio;
echo $profile->website;

// العلاقة العكسية
$profile = Profile::find(1);
$user = $profile->user;  // يُرجع نموذج User

echo $user->name;

// إنشاء سجل ذي صلة
$user = User::find(1);
$user->profile()->create([
    'bio' => 'مطور Laravel',
    'website' => 'https://example.com',
    'avatar' => 'avatar.jpg',
]);

// تحديث سجل ذي صلة
$user->profile->update([
    'bio' => 'سيرة ذاتية محدثة',
]);

// جدول users
id | name | email | created_at | updated_at

// جدول posts
id | user_id | title | content | published_at | created_at | updated_at

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    // المستخدم لديه العديد من المنشورات
    public function posts()
    {
        return $this->hasMany(Post::class);
    }
}

class Post extends Model
{
    protected $fillable = ['title', 'content', 'published_at'];

    // المنشور ينتمي إلى المستخدم
    public function user()
    {
        return $this->belongsTo(User::class);
    }
}

// الوصول إلى جميع منشورات المستخدم
$user = User::find(1);
$posts = $user->posts;  // يُرجع مجموعة من نماذج Post

foreach ($posts as $post) {
    echo $post->title;
}

// الاستعلام عن العلاقة
$publishedPosts = $user->posts()
    ->where('published_at', '!=', null)
    ->orderBy('published_at', 'desc')
    ->get();

// عد السجلات ذات الصلة
$postCount = $user->posts()->count();

// التحقق من وجود العلاقة
if ($user->posts()->exists()) {
    echo "المستخدم لديه منشورات";
}

// إنشاء سجل ذي صلة
$user->posts()->create([
    'title' => 'منشوري الجديد',
    'content' => 'محتوى المنشور هنا...',
    'published_at' => now(),
]);

// حفظ نموذج موجود
$post = new Post([
    'title' => 'منشور آخر',
    'content' => 'المزيد من المحتوى...',
]);
$user->posts()->save($post);

// حفظ نماذج متعددة
$user->posts()->saveMany([
    new Post(['title' => 'منشور 1']),
    new Post(['title' => 'منشور 2']),
]);

// جدول posts
id | title | content | created_at | updated_at

// جدول tags
id | name | slug | created_at | updated_at

// جدول post_tag (جدول محوري)
id | post_id | tag_id | created_at | updated_at

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    // المنشور ينتمي إلى العديد من العلامات
    public function tags()
    {
        return $this->belongsToMany(Tag::class);
    }
}

class Tag extends Model
{
    protected $fillable = ['name', 'slug'];

    // العلامة تنتمي إلى العديد من المنشورات
    public function posts()
    {
        return $this->belongsToMany(Post::class);
    }
}

// الوصول إلى جميع علامات المنشور
$post = Post::find(1);
$tags = $post->tags;

foreach ($tags as $tag) {
    echo $tag->name;
}

// الوصول إلى جميع المنشورات بعلامة محددة
$tag = Tag::where('slug', 'laravel')->first();
$posts = $tag->posts;

// إرفاق العلامات بمنشور (إضافة علاقات)
$post->tags()->attach([1, 2, 3]);  // بالمعرفات
$post->tags()->attach($tag);       // بالنموذج

// فصل العلامات (إزالة العلاقات)
$post->tags()->detach([1, 2]);     // إزالة علامات محددة
$post->tags()->detach();           // إزالة جميع العلامات

// مزامنة العلامات (استبدال جميع الموجودة)
$post->tags()->sync([1, 2, 3]);

// المزامنة بدون فصل
$post->tags()->syncWithoutDetaching([4, 5]);

// تبديل العلامات (إرفاق إذا لم تكن مرفقة، فصل إذا كانت مرفقة)
$post->tags()->toggle([1, 2, 3]);

<?php

// تعريف أعمدة محورية في العلاقة
class Post extends Model
{
    public function tags()
    {
        return $this->belongsToMany(Tag::class)
            ->withPivot('featured', 'order')
            ->withTimestamps();
    }
}

// الوصول إلى بيانات محورية
$post = Post::find(1);
foreach ($post->tags as $tag) {
    echo $tag->name;
    echo $tag->pivot->featured;
    echo $tag->pivot->order;
    echo $tag->pivot->created_at;
}

// الإرفاق مع بيانات محورية
$post->tags()->attach(1, [
    'featured' => true,
    'order' => 1
]);

// المزامنة مع بيانات محورية
$post->tags()->sync([
    1 => ['featured' => true, 'order' => 1],
    2 => ['featured' => false, 'order' => 2],
]);

// جدول countries
id | name

// جدول users
id | country_id | name

// جدول posts
id | user_id | title | content

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Country extends Model
{
    // الدولة لديها العديد من المنشورات من خلال المستخدمين
    public function posts()
    {
        return $this->hasManyThrough(
            Post::class,      // النموذج النهائي
            User::class,      // النموذج الوسيط
            'country_id',    // المفتاح الخارجي على جدول users
            'user_id',       // المفتاح الخارجي على جدول posts
            'id',            // المفتاح المحلي على جدول countries
            'id'             // المفتاح المحلي على جدول users
        );
    }
}

$country = Country::find(1);
$posts = $country->posts;  // جميع المنشورات من قبل المستخدمين في هذه الدولة

foreach ($posts as $post) {
    echo $post->title;
}

// جدول posts
id | title | content

// جدول videos
id | title | url

// جدول comments
id | body | commentable_id | commentable_type | created_at

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Comment extends Model
{
    protected $fillable = ['body'];

    // التعليق ينتمي إلى commentable (منشور أو فيديو)
    public function commentable()
    {
        return $this->morphTo();
    }
}

class Post extends Model
{
    // المنشور لديه العديد من التعليقات (متعدد الأشكال)
    public function comments()
    {
        return $this->morphMany(Comment::class, 'commentable');
    }
}

class Video extends Model
{
    // الفيديو لديه العديد من التعليقات (متعدد الأشكال)
    public function comments()
    {
        return $this->morphMany(Comment::class, 'commentable');
    }
}

// إنشاء تعليقات لمنشور
$post = Post::find(1);
$post->comments()->create([
    'body' => 'منشور رائع!'
]);

// إنشاء تعليقات لفيديو
$video = Video::find(1);
$video->comments()->create([
    'body' => 'فيديو جميل!'
]);

// استرجاع جميع التعليقات
$post->comments;   // تعليقات للمنشور
$video->comments;  // تعليقات للفيديو

// العلاقة العكسية (الحصول على الأصل)
$comment = Comment::find(1);
$commentable = $comment->commentable;  // يُرجع Post أو Video

if ($commentable instanceof Post) {
    echo "تعليق على منشور: " . $commentable->title;
} elseif ($commentable instanceof Video) {
    echo "تعليق على فيديو: " . $commentable->title;
}

// سيء: استعلامات N+1 (1 + 100 = 101 استعلام لـ 100 مستخدم)
$users = User::all();  // استعلام واحد

foreach ($users as $user) {
    echo $user->posts->count();  // 100 استعلام إضافي!
}

// جيد: التحميل الحريص (استعلامان فقط)
$users = User::with('posts')->get();  // استعلامان إجماليًا

foreach ($users as $user) {
    echo $user->posts->count();  // لا استعلامات إضافية!
}

// تحميل حريص لعلاقات متعددة
$posts = Post::with(['user', 'tags', 'comments'])->get();

// تحميل حريص متداخل
$countries = Country::with('users.posts')->get();

// تحميل حريص مشروط
$users = User::with([
    'posts' => function ($query) {
        $query->where('published_at', '!=', null)
              ->orderBy('published_at', 'desc')
              ->limit(5);
    }
])->get();

// تحميل حريص لأعمدة محددة
$users = User::with('posts:id,user_id,title')->get();

$users = User::all();

// تحميل العلاقة بعد استرجاع النماذج
if ($someCondition) {
    $users->load('posts');
}

// التحميل مع القيود
$users->load([
    'posts' => function ($query) {
        $query->where('published', true);
    }
]);

// Has: الحصول على المستخدمين الذين لديهم منشور واحد على الأقل
$users = User::has('posts')->get();

// Has مع العد
$users = User::has('posts', '>=', 3)->get();

// WhereHas: الحصول على المستخدمين مع المنشورات المنشورة
$users = User::whereHas('posts', function ($query) {
    $query->where('published_at', '!=', null);
})->get();

// DoesntHave: الحصول على المستخدمين بدون منشورات
$users = User::doesntHave('posts')->get();

// WhereDoesntHave: الحصول على المستخدمين بدون منشورات منشورة
$users = User::whereDoesntHave('posts', function ($query) {
    $query->where('published_at', '!=', null);
})->get();

// عد السجلات ذات الصلة
$users = User::withCount('posts')->get();

foreach ($users as $user) {
    echo $user->posts_count;  // سمة posts_count مضافة
}