Polymorphic Relationship در Laravel چیست؟

تاریخ انتشار: 2026/06/18 13:55 بازدید: 6 نویسنده: Admin

Polymorphic Relationship در Laravel یکی از قابلیت‌های پیشرفته Eloquent ORM است که به شما اجازه می‌دهد یک مدل، با چند مدل مختلف رابطه داشته باشد؛ بدون اینکه برای هر نوع رابطه، جدول یا ستون جداگانه طراحی کنید. این نوع رابطه در پروژه‌های واقعی مثل سیستم نظرات، فایل‌ها، تصاویر، لاگ‌ها، تگ‌ها، اعلان‌ها و ماژول‌های محتوایی کاربرد زیادی دارد. در این مقاله به‌صورت کامل بررسی می‌کنیم Polymorphic Relationship در Laravel چیست، چه زمانی باید از آن استفاده کنیم، چطور پیاده‌سازی می‌شود، چه مزایا و چالش‌هایی دارد و در پروژه‌های نرم‌افزار تحت وب چه نقشی در طراحی دیتابیس تمیز، توسعه‌پذیر و مقیاس‌پذیر ایفا می‌کند.

1.0x

برای شنیدن متن، روی «پخش صوت مقاله» بزنید.

مقدمه: چرا Polymorphic Relationship در Laravel مهم است؟

در توسعه نرم‌افزارهای تحت وب، طراحی دیتابیس یکی از تصمیم‌های مهم و اثرگذار بر آینده پروژه است. بسیاری از مشکلاتی که در پروژه‌های بزرگ رخ می‌دهد، از همان مرحله طراحی مدل‌ها و روابط دیتابیس شروع می‌شود. گاهی در ابتدای پروژه همه چیز ساده به نظر می‌رسد؛ مثلاً یک سیستم وبلاگ داریم که هر مقاله می‌تواند چند نظر داشته باشد. اما کمی بعد، نیاز جدیدی مطرح می‌شود: محصولات هم باید نظر داشته باشند، دوره‌های آموزشی هم باید نظر داشته باشند، صفحات خدمات هم باید نظر داشته باشند و حتی کاربران هم ممکن است بازخورد دریافت کنند.

در چنین شرایطی، یک راه ساده ولی غیراصولی این است که برای هر موجودیت، جدول جداگانه‌ای برای نظرات بسازیم؛ مثلاً post_comments، product_comments، course_comments و غیره. این روش شاید در کوتاه‌مدت کار کند، اما در بلندمدت باعث تکرار کد، پیچیدگی کوئری‌ها، سختی نگهداری و افزایش هزینه توسعه می‌شود.

راه حرفه‌ای‌تر استفاده از Polymorphic Relationship در Laravel است. این نوع رابطه به ما اجازه می‌دهد یک مدل مثل Comment بتواند به چند مدل مختلف مثل Post، Product یا Course متصل شود. به‌عبارت ساده‌تر، به‌جای اینکه برای هر نوع محتوا یک سیستم نظر جداگانه بسازیم، یک ساختار عمومی و منعطف طراحی می‌کنیم.

در پروژه‌های شرکتی، فروشگاهی، سامانه‌های مالی، CRM، سیستم‌های مدیریت محتوا و نرم‌افزارهای اختصاصی، این موضوع بسیار مهم است. شرکت‌هایی مثل اسمارتی اپ (SmartyApp) که در حوزه طراحی سایت، تولید نرم‌افزار اختصاصی و برنامه‌نویسی نرم‌افزارهای تحت وب فعالیت می‌کنند، هنگام طراحی معماری پروژه باید به چنین الگوهایی توجه ویژه داشته باشند؛ چون تصمیم درست در سطح دیتابیس می‌تواند سال‌ها هزینه توسعه و نگهداری را کاهش دهد.

 

Polymorphic Relationship در Laravel چیست؟

Polymorphic Relationship یا رابطه چندریختی در Laravel نوعی رابطه در Eloquent ORM است که در آن یک مدل می‌تواند به بیش از یک نوع مدل دیگر تعلق داشته باشد. واژه Polymorphic در برنامه‌نویسی به معنای «چندریختی» است؛ یعنی یک ساختار می‌تواند در موقعیت‌های مختلف رفتار یا ارتباط متفاوتی داشته باشد.

در Laravel، رابطه‌های معمولی مثل hasOne، hasMany و belongsTo معمولاً بین دو مدل مشخص تعریف می‌شوند. مثلاً یک کاربر چند سفارش دارد یا هر سفارش متعلق به یک کاربر است. اما در رابطه Polymorphic، مدل مقصد می‌تواند متغیر باشد.

برای مثال، فرض کنید در سیستم شما یک مدل Image دارید. این تصویر می‌تواند متعلق به موارد مختلفی باشد:

  • تصویر پروفایل کاربر
  • تصویر شاخص مقاله
  • تصویر محصول
  • تصویر گالری پروژه
  • تصویر مربوط به یک خدمت

در طراحی سنتی شاید برای هر مورد یک جدول جداگانه یا چند ستون جداگانه ایجاد کنید. اما با Polymorphic Relationship می‌توانید یک جدول images داشته باشید که مشخص می‌کند هر تصویر متعلق به چه مدلی و چه رکوردی است.

ساختار اصلی این رابطه معمولاً با دو ستون ساخته می‌شود:

imageable_id imageable_type

ستون imageable_id شناسه رکورد مرتبط را نگه می‌دارد و ستون imageable_type نام کلاس مدل مرتبط را ذخیره می‌کند. مثلاً اگر تصویر مربوط به مقاله باشد، مقدار imageable_type می‌تواند App\Models\Post باشد و اگر مربوط به محصول باشد، مقدار آن می‌تواند App\Models\Product باشد.

 

تفاوت رابطه معمولی و رابطه Polymorphic

برای درک بهتر، رابطه معمولی را با رابطه چندریختی مقایسه کنیم.

در رابطه معمولی، جدول comments ممکن است فقط برای مقاله‌ها طراحی شود:

comments - id - post_id - body

در این حالت هر Comment فقط می‌تواند به یک Post تعلق داشته باشد. اما اگر بخواهیم Product هم Comment داشته باشد، باید یا ستون جدید اضافه کنیم یا جدول جدید بسازیم.

در رابطه Polymorphic ساختار این‌گونه می‌شود:

comments - id - commentable_id - commentable_type - body

حالا هر Comment می‌تواند به هر مدلی که قابلیت کامنت‌گذاری دارد متصل شود؛ مثلاً Post، Product یا Course.

جدول مقایسه رابطه معمولی و Polymorphic Relationship

معیار مقایسهرابطه معمولیPolymorphic Relationship
تعداد مدل‌های قابل اتصالمعمولاً یک مدل مشخصچند مدل مختلف
ساختار دیتابیسساده ولی محدودمنعطف‌تر و عمومی‌تر
مناسب برایروابط ثابت و مشخصروابط مشترک بین چند موجودیت
مثال کاربردیهر سفارش متعلق به یک کاربرهر نظر متعلق به مقاله، محصول یا دوره
میزان توسعه‌پذیریمتوسطبالا
پیچیدگی کوئریکمترکمی بیشتر
ریسک استفاده نادرستکمتربیشتر در صورت طراحی ضعیف
کاربرد در پروژه‌های بزرگمحدود به روابط مشخصبسیار کاربردی برای ماژول‌های عمومی

 

انواع Polymorphic Relationship در Laravel

Laravel چند نوع رابطه Polymorphic را پشتیبانی می‌کند. مهم‌ترین آن‌ها عبارت‌اند از:

رابطه One To One Polymorphic

این رابطه زمانی استفاده می‌شود که یک مدل از میان چند مدل مختلف، فقط یک رکورد مرتبط داشته باشد. مثال رایج آن تصویر اصلی یا فایل پیوست اصلی است.

فرض کنید هر کاربر، محصول یا مقاله می‌تواند یک تصویر اصلی داشته باشد. در این حالت می‌توانیم مدل Image را به‌صورت Polymorphic تعریف کنیم.

رابطه One To Many Polymorphic

این رایج‌ترین نوع رابطه چندریختی است. در این حالت یک مدل می‌تواند چند رکورد مرتبط داشته باشد. مثال معروف آن سیستم نظرات است.

مثلاً یک مقاله چند نظر دارد، یک محصول چند نظر دارد و یک دوره آموزشی هم چند نظر دارد. به‌جای ساخت چند جدول، یک جدول comments طراحی می‌کنیم.

رابطه Many To Many Polymorphic

این نوع رابطه زمانی استفاده می‌شود که چند مدل مختلف بتوانند با چند رکورد از یک مدل دیگر ارتباط داشته باشند. نمونه رایج آن سیستم تگ‌گذاری است.

مثلاً تگ‌های Laravel، PHP، Backend و Database می‌توانند هم به مقاله‌ها وصل شوند، هم به محصولات آموزشی و هم به پروژه‌ها. در این حالت از morphToMany و morphedByMany استفاده می‌شود.

 

مثال واقعی: سیستم نظرات برای مقاله و محصول

فرض کنیم یک شرکت نرم‌افزاری در حال طراحی یک پلتفرم محتوایی و فروشگاهی است. در این سیستم، هم مقاله‌ها و هم محصولات نیاز به بخش نظرات دارند. طراحی ضعیف این است که دو جدول جداگانه بسازیم:

post_comments product_comments

این کار باعث تکرار ساختار، تکرار منطق اعتبارسنجی، تکرار پنل مدیریت و پیچیدگی گزارش‌گیری می‌شود.

طراحی بهتر این است که یک جدول عمومی برای نظرات داشته باشیم:

comments - id - commentable_id - commentable_type - user_id - body - status - created_at - updated_at

در این طراحی، هر Comment می‌تواند به هر مدلی که قابلیت دریافت نظر دارد وصل شود.

 

ساخت Migration برای رابطه Polymorphic

برای ساخت جدول comments می‌توانیم از متد morphs در Migration استفاده کنیم. مستندات رسمی Laravel درباره Migration توضیح می‌دهد که Schema Builder لاراول امکاناتی برای تعریف ساختار جداول دیتابیس به شکل مستقل از نوع دیتابیس فراهم می‌کند. برای مطالعه بیشتر می‌توانید به مستندات رسمی Laravel درباره Database Migrations مراجعه کنید.

نمونه Migration:

use Illuminate\Database\Migrations\Migration; use Illuminate\Database\Schema\Blueprint; use Illuminate\Support\Facades\Schema; return new class extends Migration {    public function up(): void    {        Schema::create('comments', function (Blueprint $table) {            $table->id();            $table->morphs('commentable');            $table->foreignId('user_id')                ->nullable()                ->constrained()                ->nullOnDelete();            $table->text('body');            $table->string('status')->default('pending');            $table->timestamps();            $table->index(['status', 'created_at']);        });    }    public function down(): void    {        Schema::dropIfExists('comments');    } };

متد زیر:

$table->morphs('commentable');

به‌صورت خودکار دو ستون ایجاد می‌کند:

commentable_id commentable_type

این دو ستون پایه اصلی رابطه Polymorphic هستند.

 

تعریف مدل Comment

در مدل Comment باید رابطه معکوس را با morphTo تعریف کنیم. در مستندات رسمی Laravel برای Eloquent Relationships، رابطه‌های Polymorphic با متدهایی مانند morphTo، morphMany، morphOne و morphToMany توضیح داده شده‌اند. برای جزئیات بیشتر می‌توانید مستندات رسمی Laravel درباره Eloquent Relationships را مطالعه کنید.

namespace App\Models; use Illuminate\Database\Eloquent\Model; use Illuminate\Database\Eloquent\Relations\MorphTo; use Illuminate\Database\Eloquent\Relations\BelongsTo; class Comment extends Model {    protected $fillable = [        'user_id',        'body',        'status',    ];    public function commentable(): MorphTo    {        return $this->morphTo();    }    public function user(): BelongsTo    {        return $this->belongsTo(User::class);    } }

متد commentable مشخص می‌کند که این نظر می‌تواند متعلق به مدل‌های مختلفی باشد.

 

تعریف رابطه در مدل Post

در مدل Post می‌توانیم رابطه را با morphMany تعریف کنیم:

namespace App\Models; use Illuminate\Database\Eloquent\Model; use Illuminate\Database\Eloquent\Relations\MorphMany; class Post extends Model {    public function comments(): MorphMany    {        return $this->morphMany(Comment::class, 'commentable');    } }

حالا هر مقاله می‌تواند چند نظر داشته باشد:

$post = Post::find(1); $post->comments()->create([    'user_id' => auth()->id(),    'body' => 'این مقاله بسیار کاربردی بود.',    'status' => 'pending', ]);

 

تعریف رابطه در مدل Product

همین ساختار را می‌توانیم در مدل Product نیز استفاده کنیم:

namespace App\Models; use Illuminate\Database\Eloquent\Model; use Illuminate\Database\Eloquent\Relations\MorphMany; class Product extends Model {    public function comments(): MorphMany    {        return $this->morphMany(Comment::class, 'commentable');    } }

اکنون بدون ایجاد جدول جدید، محصولات هم می‌توانند کامنت داشته باشند:

$product = Product::find(10); $product->comments()->create([    'user_id' => auth()->id(),    'body' => 'کیفیت محصول خوب بود اما توضیحات بیشتری نیاز دارد.',    'status' => 'approved', ]);

این دقیقاً همان نقطه‌ای است که Polymorphic Relationship در Laravel ارزش خود را نشان می‌دهد: یک منطق مشترک، چند موجودیت مختلف و کمترین تکرار در ساختار دیتابیس و کد.

 

دریافت مدل والد از Comment

یکی از قابلیت‌های مهم رابطه Polymorphic این است که از سمت مدل فرزند هم می‌توانیم به والد دسترسی داشته باشیم.

$comment = Comment::find(1); $parent = $comment->commentable;

در این مثال، $parent ممکن است یک Post باشد یا یک Product. Laravel با توجه به مقدار commentable_type و commentable_id مدل مرتبط را تشخیص می‌دهد.

مثلاً:

if ($comment->commentable instanceof Post) {    echo 'این نظر برای مقاله ثبت شده است.'; } if ($comment->commentable instanceof Product) {    echo 'این نظر برای محصول ثبت شده است.'; }

 

مثال واقعی برای کسب‌وکارها: سیستم فایل‌های پیوست

در بسیاری از سامانه‌های سازمانی، فایل‌ها فقط به یک بخش محدود نیستند. یک فایل می‌تواند مربوط به موارد زیر باشد:

  • فاکتور فروش
  • قرارداد مشتری
  • تیکت پشتیبانی
  • پروفایل کاربر
  • پروژه داخلی
  • سند حسابداری

اگر برای هر بخش جدول فایل جداگانه طراحی کنیم، خیلی زود با ساختاری شلوغ و سخت‌نگهداری روبه‌رو می‌شویم. راه بهتر این است که یک جدول attachments داشته باشیم:

attachments - id - attachable_id - attachable_type - file_name - file_path - mime_type - size - created_at - updated_at

مدل Attachment:

class Attachment extends Model {    protected $fillable = [        'file_name',        'file_path',        'mime_type',        'size',    ];    public function attachable(): MorphTo    {        return $this->morphTo();    } }

مدل Invoice:

class Invoice extends Model {    public function attachments(): MorphMany    {        return $this->morphMany(Attachment::class, 'attachable');    } }

مدل Ticket:

class Ticket extends Model {    public function attachments(): MorphMany    {        return $this->morphMany(Attachment::class, 'attachable');    } }

این الگو برای نرم‌افزارهای تحت وب سازمانی بسیار ارزشمند است؛ چون فایل، نظر، لاگ، تگ و اعلان معمولاً ماژول‌هایی هستند که بین چند بخش سیستم مشترک‌اند. در چنین پروژه‌هایی، تیم فنی اسمارتی اپ (SmartyApp) می‌تواند با طراحی درست رابطه‌ها، ساختاری ایجاد کند که در آینده به‌راحتی توسعه پیدا کند.

 

Polymorphic One To One با morphOne

گاهی هر مدل فقط یک رکورد مرتبط نیاز دارد. مثلاً هر مقاله یا محصول فقط یک تصویر شاخص دارد.

Migration جدول تصاویر:

Schema::create('images', function (Blueprint $table) {    $table->id();    $table->morphs('imageable');    $table->string('path');    $table->string('alt')->nullable();    $table->timestamps(); });

مدل Image:

class Image extends Model {    protected $fillable = [        'path',        'alt',    ];    public function imageable(): MorphTo    {        return $this->morphTo();    } }

مدل Post:

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

استفاده:

$post->image()->create([    'path' => 'uploads/posts/laravel-polymorphic.jpg',    'alt' => 'Polymorphic Relationship در Laravel', ]);

این نوع رابطه برای تصویر شاخص، تنظیمات اختصاصی، متادیتا یا فایل اصلی هر رکورد کاربرد دارد.

 

Polymorphic Many To Many با morphToMany

یکی از کاربردی‌ترین مثال‌های رابطه چندریختی چندبه‌چند، سیستم تگ‌گذاری است. فرض کنید می‌خواهید برای مقاله‌ها، محصولات و پروژه‌ها تگ تعریف کنید. هر تگ می‌تواند به چند مقاله و چند محصول وصل شود و هر مقاله یا محصول هم می‌تواند چند تگ داشته باشد.

ساخت جدول tags:

Schema::create('tags', function (Blueprint $table) {    $table->id();    $table->string('name');    $table->string('slug')->unique();    $table->timestamps(); });

ساخت جدول واسط:

Schema::create('taggables', function (Blueprint $table) {    $table->id();    $table->foreignId('tag_id')->constrained()->cascadeOnDelete();    $table->morphs('taggable');    $table->timestamps();    $table->unique(['tag_id', 'taggable_id', 'taggable_type']); });

مدل Tag:

class Tag extends Model {    public function posts()    {        return $this->morphedByMany(Post::class, 'taggable');    }    public function products()    {        return $this->morphedByMany(Product::class, 'taggable');    } }

مدل Post:

class Post extends Model {    public function tags()    {        return $this->morphToMany(Tag::class, 'taggable');    } }

مدل Product:

class Product extends Model {    public function tags()    {        return $this->morphToMany(Tag::class, 'taggable');    } }

افزودن تگ به مقاله:

$post->tags()->attach($tagId);

دریافت مقاله‌های مرتبط با یک تگ:

$tag = Tag::where('slug', 'laravel')->first(); $posts = $tag->posts;

این ساختار برای سایت‌های محتوایی، فروشگاه‌ها، مارکت‌پلیس‌ها و سامانه‌های آموزشی بسیار کاربردی است.

 

چه زمانی از Polymorphic Relationship استفاده کنیم؟

استفاده از Polymorphic Relationship زمانی مناسب است که یک مدل یا قابلیت مشترک، باید به چند مدل مختلف وصل شود. چند نمونه رایج:

سیستم نظرات

اگر مقاله، محصول، دوره آموزشی، پروژه و صفحه خدمات همگی نیاز به نظر دارند، رابطه Polymorphic گزینه مناسبی است.

سیستم فایل و پیوست

اگر فایل‌ها می‌توانند به فاکتور، قرارداد، کاربر، تیکت یا پروژه متصل شوند، بهتر است از رابطه چندریختی استفاده شود.

سیستم تصاویر

اگر تصاویر برای چند نوع موجودیت مختلف استفاده می‌شوند، مثل تصویر محصول، تصویر مقاله و تصویر نمونه‌کار، رابطه Polymorphic ساختار تمیزی ایجاد می‌کند.

سیستم لاگ و فعالیت‌ها

در سامانه‌های مدیریتی، ممکن است بخواهید فعالیت‌های مختلف را ثبت کنید؛ مثلاً تغییر سفارش، ویرایش فاکتور، ثبت تیکت یا بروزرسانی پروفایل. در این حالت یک جدول activities می‌تواند با چند مدل مختلف ارتباط داشته باشد.

سیستم اعلان‌ها

اعلان‌ها ممکن است مربوط به سفارش، پرداخت، پیام، تیکت یا قرارداد باشند. رابطه Polymorphic می‌تواند مدل مقصد اعلان را منعطف کند.

 

چه زمانی نباید از Polymorphic Relationship استفاده کنیم؟

با وجود مزایای زیاد، Polymorphic Relationship همیشه بهترین گزینه نیست. اگر رابطه بین دو مدل کاملاً مشخص، ثابت و دارای قواعد تجاری خاص است، رابطه معمولی بهتر است.

مثلاً رابطه بین Order و User معمولاً نباید Polymorphic باشد. هر سفارش متعلق به یک کاربر یا مشتری مشخص است و این رابطه دامنه مشخصی دارد.

همچنین اگر برای هر نوع مدل مرتبط، منطق کاملاً متفاوت، فیلدهای اختصاصی زیاد و گزارش‌گیری پیچیده دارید، بهتر است قبل از انتخاب رابطه Polymorphic طراحی دیتابیس را دقیق‌تر بررسی کنید.

استفاده بیش از حد از Polymorphic Relationship ممکن است باعث شود ساختار سیستم بیش از اندازه عمومی و مبهم شود. هدف از این رابطه، حذف تکرار و افزایش انعطاف است؛ نه مخفی‌کردن طراحی ضعیف پشت یک رابطه عمومی.

 

مزایای Polymorphic Relationship در Laravel

کاهش تکرار در دیتابیس

به‌جای ساخت چند جدول مشابه، می‌توانید یک جدول عمومی بسازید. این کار ساختار دیتابیس را ساده‌تر و نگهداری آن را آسان‌تر می‌کند.

کاهش تکرار در کد

وقتی منطق کامنت، فایل، تصویر یا تگ در یک مدل مشترک قرار می‌گیرد، کنترلرها، سرویس‌ها، Policyها و Queryها هم تمیزتر می‌شوند.

افزایش توسعه‌پذیری

اگر بعداً مدل جدیدی به سیستم اضافه شود، نیازی به طراحی مجدد کامل ندارید. فقط کافی است رابطه مربوطه را در مدل جدید تعریف کنید.

مناسب برای معماری ماژولار

در نرم‌افزارهای تحت وب مدرن، قابلیت‌هایی مثل فایل، لاگ، نظر و تگ معمولاً به‌صورت ماژول مستقل طراحی می‌شوند. Polymorphic Relationship این نوع طراحی را ساده‌تر می‌کند.

یکپارچگی تجربه کاربری

وقتی یک سیستم نظر یا فایل مشترک داشته باشید، پنل مدیریت و تجربه کاربری یکدست‌تر می‌شود. مدیر سیستم می‌تواند همه نظرات یا فایل‌ها را از یک بخش بررسی کند.

 

چالش‌های Polymorphic Relationship در Laravel

نبود Foreign Key مستقیم روی مدل مقصد

در رابطه معمولی، می‌توانیم برای post_id یک Foreign Key مستقیم تعریف کنیم. اما در رابطه Polymorphic، چون commentable_type می‌تواند به چند جدول مختلف اشاره کند، دیتابیس نمی‌تواند به‌سادگی یک Foreign Key مستقیم برای همه مدل‌ها ایجاد کند.

این موضوع یعنی بخشی از کنترل صحت داده‌ها بر عهده لایه اپلیکیشن قرار می‌گیرد.

پیچیدگی در گزارش‌گیری

اگر بخواهید گزارش‌های پیچیده بین چند مدل بگیرید، کوئری‌ها ممکن است پیچیده‌تر شوند. مثلاً گزارش تعداد نظرات تأییدشده به تفکیک نوع محتوا نیاز به دقت بیشتری دارد.

وابستگی به نام کلاس مدل

به‌صورت پیش‌فرض، Laravel نام کامل کلاس مدل را در ستون *_type ذخیره می‌کند. اگر namespace مدل‌ها تغییر کند، ممکن است داده‌های قبلی نیاز به بروزرسانی داشته باشند. برای مدیریت بهتر این موضوع، می‌توان از Morph Map استفاده کرد.

احتمال استفاده بیش از حد

گاهی توسعه‌دهنده برای هر رابطه‌ای از Polymorphic استفاده می‌کند، در حالی که رابطه معمولی ساده‌تر، خواناتر و مناسب‌تر است. این کار در بلندمدت باعث پیچیدگی سیستم می‌شود.

 

Morph Map چیست و چرا اهمیت دارد؟

به‌صورت پیش‌فرض، Laravel ممکن است در ستون commentable_type مقدار کامل کلاس را ذخیره کند:

App\Models\Post App\Models\Product

این موضوع از نظر فنی کار می‌کند، اما یک مشکل دارد: ساختار دیتابیس به namespace کلاس‌های PHP وابسته می‌شود. اگر در آینده مسیر مدل‌ها تغییر کند، داده‌های ذخیره‌شده ممکن است مشکل ایجاد کنند.

راه بهتر استفاده از Morph Map است. با Morph Map می‌توانیم به‌جای نام کامل کلاس، یک نام کوتاه و پایدار ذخیره کنیم.

نمونه تنظیم در AppServiceProvider:

use Illuminate\Database\Eloquent\Relations\Relation; public function boot(): void {    Relation::enforceMorphMap([        'post' => \App\Models\Post::class,        'product' => \App\Models\Product::class,        'course' => \App\Models\Course::class,    ]); }

در این حالت، به‌جای ذخیره App\Models\Post، مقدار post در دیتابیس ذخیره می‌شود.

این روش برای پروژه‌های جدی و بلندمدت بسیار پیشنهاد می‌شود؛ چون دیتابیس را از ساختار داخلی کد مستقل‌تر می‌کند.

 

بهینه‌سازی Performance در رابطه‌های Polymorphic

Polymorphic Relationship اگر درست استفاده شود، عملکرد خوبی دارد. اما در پروژه‌های پرترافیک باید به چند نکته توجه کرد.

استفاده از Index مناسب

ستون‌های *_id و *_type باید Index داشته باشند. متد morphs معمولاً این ساختار را ایجاد می‌کند، اما در طراحی‌های سفارشی باید حتماً بررسی شود.

برای جدول comments، ترکیب زیر مهم است:

commentable_type commentable_id

اگر مرتباً نظرات را بر اساس وضعیت یا تاریخ دریافت می‌کنید، Indexهای ترکیبی هم می‌توانند مفید باشند:

$table->index(['commentable_type', 'commentable_id', 'status']); $table->index(['status', 'created_at']);

استفاده از Eager Loading

مشکل N+1 Query یکی از مشکلات رایج در ORMهاست. اگر تعداد زیادی Comment دریافت کنید و برای هرکدام والد را جداگانه بخوانید، تعداد کوئری‌ها زیاد می‌شود.

به‌جای این روش:

$comments = Comment::latest()->get(); foreach ($comments as $comment) {    echo $comment->commentable->title; }

بهتر است از Eager Loading استفاده کنید:

$comments = Comment::with('commentable')->latest()->get();

محدود کردن داده‌های برگشتی

در APIها و صفحات مدیریتی، همیشه لازم نیست همه ستون‌های مدل والد را برگردانید. بهتر است خروجی‌ها را با Resource، DTO یا Transformer کنترل کنید.

Pagination

برای نظرات، فایل‌ها و لاگ‌ها همیشه Pagination در نظر بگیرید. دریافت همه داده‌ها در یک درخواست، به‌خصوص در جدول‌های عمومی، می‌تواند به عملکرد سیستم آسیب بزند.

 

مثال کاربردی در پنل مدیریت

فرض کنید در پنل مدیریت می‌خواهید آخرین نظرات ثبت‌شده در کل سیستم را نمایش دهید؛ فرقی ندارد این نظر مربوط به مقاله است یا محصول.

$comments = Comment::with(['commentable', 'user'])    ->latest()    ->paginate(20);

در Blade:

@foreach ($comments as $comment)    <div>        <strong>{{ $comment->user?->name ?? 'کاربر مهمان' }}</strong>        <p>{{ $comment->body }}</p>        @if ($comment->commentable)            <span>                مربوط به:                {{ class_basename($comment->commentable) }}            </span>        @endif    </div> @endforeach

در پروژه‌های واقعی بهتر است به‌جای نمایش نام کلاس، یک متد استاندارد در مدل‌ها تعریف شود؛ مثلاً:

public function getDisplayTitle(): string {    return $this->title; }

و مدل‌هایی که قابلیت دریافت نظر دارند، این متد را پیاده‌سازی کنند. این کار باعث می‌شود پنل مدیریت با همه مدل‌ها رفتار یکسانی داشته باشد.

 

مثال کسب‌وکاری: سیستم CRM و فعالیت‌ها

در یک نرم‌افزار CRM، فعالیت‌ها می‌توانند مربوط به بخش‌های مختلف باشند:

  • تماس با مشتری
  • ارسال پیش‌فاکتور
  • ثبت قرارداد
  • پیگیری تیکت
  • تغییر وضعیت فرصت فروش

به‌جای اینکه برای هر بخش جدول لاگ جداگانه بسازیم، می‌توانیم یک جدول activities طراحی کنیم:

activities - id - subject_id - subject_type - user_id - action - description - created_at

در این ساختار، یک Activity می‌تواند به Customer، Invoice، Contract یا Ticket متصل شود. نتیجه این است که تاریخچه فعالیت‌های سیستم به شکل یکپارچه ذخیره می‌شود و مدیران می‌توانند گزارش‌های کامل‌تری بگیرند.

برای شرکتی که قصد توسعه یک نرم‌افزار اختصاصی دارد، این نوع طراحی اهمیت زیادی دارد. وقتی تیم توسعه از ابتدا ساختارهای قابل توسعه طراحی کند، اضافه‌کردن امکانات جدید در آینده سریع‌تر و کم‌هزینه‌تر خواهد بود. این همان چیزی است که در پروژه‌های تولید نرم‌افزار اختصاصی توسط اسمارتی اپ (SmartyApp) باید به‌صورت اصولی دیده شود.

 

بهترین روش‌ها در استفاده از Polymorphic Relationship

نام‌گذاری واضح انتخاب کنید

نام رابطه باید مفهوم عمومی داشته باشد. مثلاً:

commentable imageable attachable taggable loggable notifiable

این نام‌ها نشان می‌دهند مدل مربوطه قابلیت دریافت کامنت، تصویر، فایل، تگ، لاگ یا اعلان دارد.

از Morph Map استفاده کنید

در پروژه‌های جدی بهتر است Morph Map تعریف کنید تا نام کلاس‌ها مستقیماً در دیتابیس ذخیره نشوند.

Indexها را جدی بگیرید

جدول‌های Polymorphic معمولاً رشد زیادی دارند. جدول‌هایی مثل comments، logs، attachments و activities ممکن است میلیون‌ها رکورد داشته باشند. بدون Index مناسب، سرعت سیستم کاهش پیدا می‌کند.

Validation را دقیق بنویسید

چون دیتابیس نمی‌تواند همیشه Foreign Key مستقیم اعمال کند، باید در سطح اپلیکیشن اعتبارسنجی انجام دهید. مثلاً بررسی کنید مدل مقصد واقعاً وجود دارد و کاربر مجاز به ثبت نظر یا فایل برای آن هست.

از Policy و Authorization استفاده کنید

برای امنیت، فقط تعریف رابطه کافی نیست. باید مشخص کنید چه کسی اجازه دارد روی چه مدلی نظر ثبت کند، فایل آپلود کند یا تگ اضافه کند.

ساختار API را کنترل کنید

در APIها نباید مستقیماً commentable_type و commentable_id را بدون کنترل از کاربر دریافت کنید. بهتر است نوع‌های مجاز را مشخص کنید و ورودی را به مدل‌های معتبر Map کنید.

از Polymorphic برای همه چیز استفاده نکنید

هرجا رابطه ساده و مشخص دارید، از رابطه ساده استفاده کنید. Polymorphic برای سناریوهایی مناسب است که واقعاً چند مدل مختلف نیاز به یک قابلیت مشترک دارند.

 

خطاهای رایج در پیاده‌سازی Polymorphic Relationship

انتخاب نام نامناسب برای رابطه

اگر نام رابطه مبهم باشد، خوانایی کد پایین می‌آید. مثلاً modelable نام خوبی نیست، چون مشخص نمی‌کند این رابطه برای چه قابلیتی است.

فراموش‌کردن Eager Loading

در صفحات لیستی، فراموش‌کردن with باعث افزایش تعداد کوئری‌ها می‌شود.

ذخیره مستقیم نام کلاس بدون برنامه بلندمدت

اگر پروژه بزرگ است، بهتر است از همان ابتدا Morph Map تعریف شود.

نداشتن تست

رابطه‌های Polymorphic باید تست شوند؛ مخصوصاً زمانی که چند مدل مختلف از یک رابطه استفاده می‌کنند.

ترکیب بیش از حد منطق‌های متفاوت

اگر مدل‌های مختلف رفتارهای کاملاً متفاوتی دارند، قرار دادن همه آن‌ها زیر یک رابطه عمومی ممکن است طراحی را پیچیده کند.

 

نمونه تست برای رابطه Polymorphic

در پروژه‌های حرفه‌ای، تست‌نویسی برای رابطه‌ها ضروری است. نمونه تست ساده:

public function test_post_can_have_comments(): void {    $post = Post::factory()->create();    $comment = $post->comments()->create([        'body' => 'نظر تستی',        'status' => 'approved',    ]);    $this->assertInstanceOf(Post::class, $comment->commentable);    $this->assertEquals($post->id, $comment->commentable->id); }

نمونه تست برای Product:

public function test_product_can_have_comments(): void {    $product = Product::factory()->create();    $comment = $product->comments()->create([        'body' => 'نظر محصول',        'status' => 'approved',    ]);    $this->assertInstanceOf(Product::class, $comment->commentable); }

این تست‌ها کمک می‌کنند مطمئن شویم رابطه برای مدل‌های مختلف درست کار می‌کند.

 

کاربرد Polymorphic Relationship در معماری نرم‌افزار تحت وب

در نرم‌افزارهای تحت وب، به‌خصوص پروژه‌هایی که رشد تدریجی دارند، قابلیت توسعه‌پذیری بسیار مهم است. ممکن است امروز فقط مقاله و محصول داشته باشید، اما شش ماه بعد دوره آموزشی، نمونه‌کار، صفحه فرود، فرم استخدام و تیکت پشتیبانی هم به سیستم اضافه شود.

اگر از ابتدا برای قابلیت‌های مشترک مثل نظر، فایل، تصویر، تگ و لاگ طراحی منعطف داشته باشید، اضافه‌کردن بخش‌های جدید ساده‌تر می‌شود. Polymorphic Relationship یکی از ابزارهایی است که به معمار نرم‌افزار کمک می‌کند ساختارهایی قابل توسعه و قابل نگهداری طراحی کند.

البته باید توجه داشت که این قابلیت جایگزین تحلیل درست دامنه کسب‌وکار نیست. قبل از انتخاب رابطه چندریختی باید مشخص شود آیا واقعاً چند موجودیت مختلف رفتار مشترک دارند یا فقط از نظر ظاهری شبیه به هم هستند.

 

نمونه سناریوی کامل برای یک شرکت خدماتی

فرض کنید یک شرکت خدماتی وب‌سایتی دارد که شامل بخش‌های زیر است:

  • مقالات آموزشی
  • خدمات شرکت
  • نمونه‌کارها
  • محصولات دیجیتال
  • فرم‌های درخواست مشاوره

این شرکت می‌خواهد برای همه این بخش‌ها امکان فایل، تصویر، تگ و نظر داشته باشد. طراحی سنتی ممکن است چندین جدول مشابه ایجاد کند. اما طراحی بهتر این است:

comments attachments images tags taggables

هر بخش از سیستم فقط رابطه موردنیاز خود را تعریف می‌کند. مثلاً Service می‌تواند تصویر و فایل داشته باشد، Post می‌تواند تصویر، تگ و نظر داشته باشد و Portfolio می‌تواند تصویر و تگ داشته باشد.

این طراحی باعث می‌شود تیم توسعه بتواند امکانات جدید را بدون بازنویسی بخش‌های قبلی اضافه کند. در پروژه‌های نرم‌افزار تحت وب که توسط اسمارتی اپ (SmartyApp) طراحی می‌شوند، چنین رویکردی می‌تواند به افزایش کیفیت فنی، کاهش هزینه توسعه و بهبود تجربه کاربری نهایی کمک کند.

 

FAQ: سوالات متداول درباره Polymorphic Relationship در Laravel

1. Polymorphic Relationship در Laravel چیست؟

Polymorphic Relationship نوعی رابطه در Eloquent است که اجازه می‌دهد یک مدل به چند نوع مدل مختلف مرتبط شود. مثلاً یک مدل Comment می‌تواند هم برای Post استفاده شود و هم برای Product.

2. تفاوت morphTo و morphMany چیست؟

morphTo در مدل فرزند تعریف می‌شود و مشخص می‌کند این مدل به یک مدل والد از نوع‌های مختلف تعلق دارد. اما morphMany در مدل والد تعریف می‌شود و نشان می‌دهد آن مدل می‌تواند چند رکورد از مدل فرزند داشته باشد.

3. چه زمانی باید از Polymorphic Relationship استفاده کنیم؟

وقتی یک قابلیت مشترک مثل نظر، فایل، تصویر، تگ یا لاگ باید به چند مدل مختلف متصل شود، استفاده از Polymorphic Relationship مناسب است.

4. آیا Polymorphic Relationship برای همه روابط مناسب است؟

خیر. اگر رابطه بین دو مدل مشخص و ثابت است، بهتر است از روابط معمولی مثل belongsTo، hasMany یا belongsToMany استفاده شود.

5. آیا در رابطه Polymorphic می‌توان Foreign Key تعریف کرد؟

به‌صورت مستقیم و ساده مثل رابطه‌های معمولی نه، چون یک ستون type می‌تواند به جدول‌های مختلف اشاره کند. بنابراین باید بخشی از کنترل صحت داده در سطح اپلیکیشن انجام شود.

6. morphs در Migration چه کاری انجام می‌دهد؟

متد morphs دو ستون ایجاد می‌کند: یکی برای شناسه رکورد مرتبط و دیگری برای نوع مدل مرتبط. مثلاً commentable_id و commentable_type.

7. Morph Map چه کاربردی دارد؟

Morph Map کمک می‌کند به‌جای ذخیره نام کامل کلاس در دیتابیس، یک نام کوتاه و پایدار مثل post یا product ذخیره شود. این کار نگهداری پروژه را بهتر می‌کند.

8. آیا Polymorphic Relationship روی Performance اثر منفی دارد؟

اگر بدون Index، بدون Eager Loading و بدون طراحی درست استفاده شود، ممکن است باعث کاهش عملکرد شود. اما در صورت استفاده صحیح، برای بسیاری از پروژه‌ها کاملاً مناسب و کارآمد است.

9. رابطه morphToMany چه کاربردی دارد؟

برای رابطه چندبه‌چند چندریختی استفاده می‌شود. مثال رایج آن سیستم تگ‌گذاری است که در آن تگ‌ها می‌توانند به مقاله‌ها، محصولات یا دوره‌ها متصل شوند.

10. آیا Polymorphic Relationship برای سیستم فایل مناسب است؟

بله. یکی از بهترین کاربردهای آن سیستم فایل و پیوست است؛ چون فایل‌ها معمولاً می‌توانند به چند بخش مختلف سیستم مثل فاکتور، تیکت، قرارداد یا کاربر متصل شوند.

11. آیا می‌توان Polymorphic Relationship را در API استفاده کرد؟

بله، اما باید ورودی‌ها با دقت اعتبارسنجی شوند. نباید اجازه داد کاربر هر مقدار دلخواهی برای type و id ارسال کند. بهتر است نوع‌های مجاز در سمت سرور کنترل شوند.

12. آیا Polymorphic Relationship در پروژه‌های بزرگ پیشنهاد می‌شود؟

بله، به شرطی که درست و هدفمند استفاده شود. در پروژه‌های بزرگ برای ماژول‌های عمومی مثل comments، attachments، logs و tags بسیار مفید است.

 

جمع‌بندی

Polymorphic Relationship در Laravel یکی از قابلیت‌های قدرتمند Eloquent ORM برای طراحی روابط منعطف و توسعه‌پذیر است. این رابطه زمانی کاربرد دارد که یک مدل مشترک باید به چند مدل مختلف متصل شود؛ مثل نظرها، فایل‌ها، تصاویر، تگ‌ها، لاگ‌ها و اعلان‌ها.

با استفاده درست از این قابلیت می‌توان از تکرار جدول‌ها و کدها جلوگیری کرد، معماری سیستم را تمیزتر نگه داشت و توسعه آینده پروژه را ساده‌تر کرد. با این حال، استفاده نادرست از آن می‌تواند باعث پیچیدگی، کاهش خوانایی و سختی گزارش‌گیری شود. بنابراین باید قبل از پیاده‌سازی، دامنه مسئله، نوع داده‌ها، حجم احتمالی رکوردها، نیازهای گزارش‌گیری و قواعد تجاری بررسی شود.

برای پروژه‌های نرم‌افزار تحت وب، به‌خصوص پروژه‌هایی که قرار است در طول زمان رشد کنند، Polymorphic Relationship یک ابزار مهم در طراحی دیتابیس و معماری نرم‌افزار است. اگر این رابطه همراه با Morph Map، Index مناسب، Eager Loading، Validation و تست‌نویسی استفاده شود، می‌تواند ساختاری حرفه‌ای، قابل نگهداری و مقیاس‌پذیر ایجاد کند.

 

CTA: نیاز به طراحی نرم‌افزار تحت وب حرفه‌ای دارید؟

اگر قصد دارید یک نرم‌افزار اختصاصی، سامانه تحت وب، پنل مدیریتی، CRM، مارکت‌پلیس، سیستم مالی یا پلتفرم محتوایی طراحی کنید، معماری دیتابیس و انتخاب رابطه‌های درست در Laravel نقش بسیار مهمی در کیفیت نهایی پروژه دارد.

تیم اسمارتی اپ (SmartyApp) در زمینه طراحی سایت، تولید نرم‌افزار اختصاصی و برنامه‌نویسی نرم‌افزارهای تحت وب فعالیت می‌کند و می‌تواند در تحلیل، طراحی، توسعه و بهینه‌سازی پروژه‌های Laravel به شما کمک کند.

برای دریافت مشاوره فنی، بررسی ایده یا طراحی نرم‌افزار اختصاصی متناسب با نیاز کسب‌وکار خود، با تیم اسمارتی اپ در ارتباط باشید.

 

منابع رسمی

  1. مستندات رسمی Laravel درباره Eloquent Relationships
  2. مستندات رسمی Laravel درباره Database Migrations
  3. مستندات API رسمی Laravel برای کلاس‌های Relation در Eloquent
  4. مستندات رسمی Laravel درباره Eloquent ORM
برچسب‌ها: آموزش Laravel Laravel ORM morphOne morphMany morphTo morphToMany توسعه نرم افزار تحت وب Polymorphic Relationship در Laravel Laravel Polymorphic Relationship رابطه چندریختی در لاراول Eloquent Relationships طراحی دیتابیس در Laravel