Eloquent المتقدم: التعدد الشكلي وخرائط التحويل

<?php

// ترحيل قاعدة البيانات للتعليقات متعددة الأشكال
Schema::create('comments', function (Blueprint $table) {
    $table->id();
    $table->text('body');
    $table->morphs('commentable'); // ينشئ commentable_id و commentable_type
    $table->timestamps();
});

// نموذج التعليق
class Comment extends Model
{
    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' => 'فيديو مذهل!']);

// استرجاع العنصر الأب
$comment = Comment::find(1);
$parent = $comment->commentable; // يرجع نسخة من Post أو Video

<?php

// app/Providers/AppServiceProvider.php
use Illuminate\Database\Eloquent\Relations\Relation;

public function boot()
{
    Relation::enforceMorphMap([
        'post' => 'App\Models\Post',
        'video' => 'App\Models\Video',
        'user' => 'App\Models\User',
    ]);
}

// ستخزن قاعدة البيانات الآن 'post' بدلاً من 'App\Models\Post'
// هذا يجعل الكود أكثر قابلية للصيانة ومستقلاً عن قاعدة البيانات

// استرجاع خريطة التحويل
$map = Relation::morphMap();

// الحصول على الاسم المستعار للنموذج
$alias = Relation::getMorphAlias(Post::class); // يرجع 'post'

<?php

// ترحيل قاعدة البيانات لجدول taggables
Schema::create('tags', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->timestamps();
});

Schema::create('taggables', function (Blueprint $table) {
    $table->foreignId('tag_id')->constrained()->onDelete('cascade');
    $table->morphs('taggable');
    $table->timestamps();
});

// نموذج الوسم
class Tag extends Model
{
    public function posts()
    {
        return $this->morphedByMany(Post::class, 'taggable');
    }

    public function videos()
    {
        return $this->morphedByMany(Video::class, 'taggable');
    }
}

// نموذج المنشور
class Post extends Model
{
    public function tags()
    {
        return $this->morphToMany(Tag::class, 'taggable');
    }
}

// نموذج الفيديو
class Video extends Model
{
    public function tags()
    {
        return $this->morphToMany(Tag::class, 'taggable');
    }
}

// الاستخدام
$post = Post::find(1);
$post->tags()->attach([1, 2, 3]);

$tag = Tag::find(1);
$allPosts = $tag->posts; // جميع المنشورات بهذا الوسم
$allVideos = $tag->videos; // جميع الفيديوهات بهذا الوسم

// إزالة الوسوم
$post->tags()->detach([2, 3]);

// مزامنة الوسوم (إرفاق جديد، إزالة المفقود)
$post->tags()->sync([1, 4, 5]);

<?php

// علاقة واحد لواحد متعددة الأشكال
class Image extends Model
{
    public function imageable()
    {
        return $this->morphTo();
    }
}

class User extends Model
{
    public function image()
    {
        return $this->morphOne(Image::class, 'imageable');
    }
}

class Product extends Model
{
    public function images()
    {
        return $this->morphMany(Image::class, 'imageable');
    }
}

// نطاقات استعلام متعددة الأشكال مخصصة
class Comment extends Model
{
    public function commentable()
    {
        return $this->morphTo();
    }

    public function scopeForPosts($query)
    {
        return $query->where('commentable_type', 'post');
    }

    public function scopeForVideos($query)
    {
        return $query->where('commentable_type', 'video');
    }
}

// الاستخدام
$postComments = Comment::forPosts()->get();
$videoComments = Comment::forVideos()->get();

// التحميل المسبق للعلاقات متعددة الأشكال
$comments = Comment::with('commentable')->get();

// التحميل المسبق المقيد
$comments = Comment::with([
    'commentable' => function ($query) {
        $query->where('status', 'published');
    }
])->get();

// قيود التحميل المسبق متعدد الأشكال
$posts = Post::with([
    'comments' => function ($query) {
        $query->where('approved', true);
    }
])->get();

<?php

// علاقات متعددة الأشكال متداخلة
class Activity extends Model
{
    public function subject()
    {
        return $this->morphTo();
    }

    public function causer()
    {
        return $this->morphTo();
    }
}

// تسجيل النشاط مع علاقات متعددة الأشكال متعددة
Activity::create([
    'subject_type' => 'post',
    'subject_id' => 1,
    'causer_type' => 'user',
    'causer_id' => 5,
    'description' => 'تم نشر المنشور',
]);

// علاقات متعددة الأشكال مع بيانات محورية
class User extends Model
{
    public function favoriteables()
    {
        return $this->hasMany(Favorite::class);
    }

    public function favoritePosts()
    {
        return $this->morphedByMany(Post::class, 'favoriteable')
            ->withPivot('favorited_at', 'notes')
            ->withTimestamps();
    }
}

// الإرفاق مع بيانات محورية
$user->favoritePosts()->attach($postId, [
    'favorited_at' => now(),
    'notes' => 'مقالة مفيدة حقاً',
]);

// استرجاع البيانات المحورية
$user->favoritePosts->each(function ($post) {
    echo $post->pivot->favorited_at;
    echo $post->pivot->notes;
});