Eloquent Many-to-Many Polymorphic with Post and Video taggable

TL;DR Laravel's many-to-many polymorphic relations can be complex when creating a tagging system for posts and videos, but with the right setup and relationships defined in Eloquent models, attaching and detaching tags is straightforward using attach and detach methods.

Mastering Eloquent Many-to-Many Polymorphic Relations in Laravel: A Tagging System for Posts and Videos

As a Fullstack Developer, you're likely no stranger to the power of polymorphic relationships in Laravel's Eloquent ORM. In this article, we'll delve into the fascinating world of many-to-many polymorphic relations, specifically tackling the challenge of creating a tagging system that seamlessly integrates with both Posts and Videos.

The Problem: A Polymorphic Tagging System

Let's assume you're building a content management platform where users can create both text-based posts and video content. Each piece of content should be able to have multiple tags associated with it, while also allowing users to add the same tag to different pieces of content. Sounds simple? Think again! The devil lies in the many-to-many relationship between Tags and Content.

The Anatomy of a Polymorphic Relationship

In Eloquent, polymorphic relationships are defined using three tables: the original model (in this case, Post or Video), the pivot table (tags), and the polymorphic model (taggable). Our pivot table will be called taggings and contain the foreign keys for both tag_id and taggable_id, which point to the respective id fields in the tags and posts/videos tables.

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

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

Notice how we're using the morphs method to define both taggable_id and taggable_type, which will store the ID and type of the associated content (Post or Video).

Defining Polymorphic Relationships

Now that our tables are set up, let's define the polymorphic relationships in Eloquent. We'll start with the Tag model:

class Tag extends Model
{
    public function taggable()
    {
        return $this->morphedByMany([Post::class, Video::class], 'taggable');
    }
}

And for completeness, we'll also define the relationship on both Post and Video models:

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

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

Attaching and Detaching Tags

With our relationships defined, let's move on to attaching and detaching tags from posts and videos. We'll use the attach and detach methods provided by Eloquent for polymorphic relationships:

$tag = Tag::find(1);
$post = Post::find(1);

// Attach the tag to the post
$post->tags()->save($tag);

// Detach the tag from the post
$post->tags()->detach($tag);

Conclusion

In this article, we've explored the intricacies of Eloquent many-to-many polymorphic relations in the context of a tagging system for posts and videos. By mastering these complex relationships, you'll be able to build robust, scalable applications that seamlessly integrate with Laravel's ORM.

Take your skills to the next level by experimenting with different scenarios and edge cases. Remember, practice makes perfect – so go ahead and try building your own polymorphic tagging system using Eloquent!