Skip to content
Cline

Getting Started

Morphism provides enhanced polymorphic relationship management for Laravel with strict type enforcement, automatic morphing, and cleaner configuration.

Installation

Section titled “Installation”
Terminal window
composer require cline/morphism

Basic Setup

Section titled “Basic Setup”

Service Provider

Section titled “Service Provider”
config/app.php
'providers' => [
    Cline\Morphism\MorphismServiceProvider::class,
],

Configuration

Section titled “Configuration”
Terminal window
php artisan vendor:publish --tag=morphism-config
config/morphism.php
return [
    'morphs' => [
        'commentable' => [
            App\Models\Post::class,
            App\Models\Video::class,
            App\Models\Article::class,
        ],
        'taggable' => [
            App\Models\Post::class,
            App\Models\Product::class,
        ],
    ],
];

Basic Usage

Section titled “Basic Usage”
use App\Models\Comment;
use App\Models\Post;


// Create polymorphic relation
$post = Post::find(1);
$comment = new Comment(['body' => 'Great post!']);
$post->comments()->save($comment);


// Query polymorphic relation
$comments = Comment::where('commentable_type', Post::class)->get();

Why Morphism?

Section titled “Why Morphism?”

Problem: Default Laravel Morphs

Section titled “Problem: Default Laravel Morphs”
// Without Morphism, morph maps use full class names
// commentable_type = "App\Models\Post"


// This breaks if you rename/move classes
// Couples database to PHP namespaces

Solution: Morphism

Section titled “Solution: Morphism”
// With Morphism, morph maps use clean aliases
// commentable_type = "post"


// Rename/move classes freely
// Database stays clean
// Type enforcement prevents invalid relations

Next Steps

Section titled “Next Steps”