Search by

ankurk91 / laravel-eloquent-relationships

ankurk91

Add missing eloquent relationships to Laravel php framework.

Package info

github.com/ankurk91/laravel-eloquent-relationships

pkg:composer/ankurk91/laravel-eloquent-relationships

Statistics

Installs: 556 377

Dependents: 2

Suggesters: 0

Stars: 58

Open Issues: 0

2.4.0 2026-02-23 06:53 UTC

This package is auto-updated.

Last update: 2026-11-09 04:16:01 UTC


README

Packagist GitHub tag License Downloads tests codecov

This package adds some missing relationships to Eloquent in Laravel.

Requirements

Package Version
PHP 8.3+
Laravel 12, 13

Installation

You can install the package via composer:

composer require ankurk91/laravel-eloquent-relationships

Usage

BelongsToOne

The BelongsToOne relation is almost identical to the standard BelongsToMany relation, except it returns a single model instead of a Collection of models, and null if there is no related model in the database (BelongsToMany returns an empty Collection in this case). Example:

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Ankurk91\Eloquent\HasBelongsToOne;
use Ankurk91\Eloquent\Relations\BelongsToOne;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;

class Restaurant extends Model
{
    use HasBelongsToOne;

    /**
     * Each restaurant has only one operator.
     */
    public function operator(): BelongsToOne
    {
        return $this->belongsToOne(User::class)
            ->wherePivot('is_operator', true);
            //->withDefault();
    }

    /**
     * Get all employees including the operator.
     */
    public function employees(): BelongsToMany
    {
        return $this->belongsToMany(User::class)
            ->withPivot('is_operator');
    }
}

Now you can access the relationship like:

<?php

// eager loading
$restaurant = Restaurant::with('operator')->first();
dump($restaurant->operator);
// lazy loading
$restaurant->load('operator');
// load nested relation
$restaurant->load('operator.profile');
// Perform operations
$restaurant->operator()->update([
    'name' => 'Taylor',
]);

MorphToOne

The MorphToOne relation is almost identical to the standard MorphToMany relation, except it returns a single model instead of a Collection of models, and null if there is no related model in the database (MorphToMany returns an empty Collection in this case). Example:

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\MorphToMany;

class Image extends Model
{
    public function posts(): MorphToMany
    {
        return $this->morphedByMany(Post::class, 'imageable');
    }

    public function videos(): MorphToMany
    {
        return $this->morphedByMany(Video::class, 'imageable');
    }
}
<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Ankurk91\Eloquent\HasMorphToOne;
use Illuminate\Database\Eloquent\Relations\MorphToMany;
use Ankurk91\Eloquent\Relations\MorphToOne;

class Post extends Model
{
    use HasMorphToOne;

    /**
     * Each post may have one featured image.
     */
    public function featuredImage(): MorphToOne
    {
        return $this->morphToOne(Image::class, 'imageable')
            ->wherePivot('featured', 1);
            //->withDefault();
    }

    /**
     * Get all images including the featured.
     */
    public function images(): MorphToMany
    {
        return $this->morphToMany(Image::class, 'imageable')
            ->withPivot('featured');
    }
}

Now you can access the relationship like:

<?php

// eager loading
$post = Post::with('featuredImage')->first();
dump($post->featuredImage);
// lazy loading
$post->load('featuredImage');

The inverse relation is available via morphedByOne():

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Ankurk91\Eloquent\HasMorphToOne;
use Ankurk91\Eloquent\Relations\MorphToOne;

class Image extends Model
{
    use HasMorphToOne;

    /**
     * Get the post this image is featured on.
     */
    public function featuredOnPost(): MorphToOne
    {
        return $this->morphedByOne(Post::class, 'imageable')
            ->wherePivot('featured', 1);
    }
}

Testing

composer test

Security

If you discover any security issues, please email pro.ankurk1[at]gmail[dot]com instead of using the issue tracker.

Attribution

License

The MIT License.