laravel-eloquent-relationships maintained by ankurk91
- php ^7.1.3
- illuminate/database ~5.7||^6.0
- illuminate/support ~5.7||^6.0
- php ^7.1.3
- illuminate/database ~5.7|^6.0
- illuminate/support ~5.7|^6.0
- php ^7.1.3
- illuminate/database 5.7.*|5.8.*
- illuminate/support 5.7.*|5.8.*
- php ^7.1.3
- illuminate/database 5.7.*
- illuminate/support 5.7.*
comments powered by Disqus
Laravel Eloquent Relationships
This package adds some missing relationships to eloquent in Laravel v5.7+
Installation
You can install the package via composer:
composer require ankurk91/laravel-eloquent-relationships
Usage
BelongsToOne
BelongsToOne relation is almost identical to standard BelongsToMany except it returns one model instead of Collection of models
and null
if there is no related model in DB (BelongsToMany returns empty Collection in this case).
Example:
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
use Ankurk91\Eloquent\BelongsToOne;
class Restaurant extends Model
{
use BelongsToOne;
/**
* Each restaurant has only one operator.
*
* @return \Ankurk91\Eloquent\Relations\BelongsToOne
*/
public function operator()
{
return $this->belongsToOne(User::class)
->wherePivot('is_operator', true);
//->withDefault();
}
/**
* Get all employees including the operator.
*
* @return \Illuminate\Database\Eloquent\Relations\BelongsToMany
*/
public function employees()
{
return $this->belongsToMany(User::class)
->withPivot('is_operator');
}
}
Now you can access the relationship like:
// eager loading
$restaurant = Restaurant::with('operator')->first();
dump($restaurant->operator);
// lazy loading
$restaurant->load('operator');
// load nested relation
$restaurant->load('operator.profile');
MorphToOne
MorphToOne relation is almost identical to standard MorphToMany except it returns one model instead of Collection of models
and null
if there is no related model in DB (MorphToMany returns empty Collection in this case).
Example:
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
class Image extends Model
{
/**
* @return \Illuminate\Database\Eloquent\Relations\MorphToMany
*/
public function posts()
{
return $this->morphedByMany(Post::class, 'imageable');
}
/**
* @return \Illuminate\Database\Eloquent\Relations\MorphToMany
*/
public function videos()
{
return $this->morphedByMany(Video::class, 'imageable');
}
}
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
use Ankurk91\Eloquent\MorphToOne;
class Post extends Model
{
use MorphToOne;
/**
* Each post has one featured image.
*
* @return \Ankurk91\Eloquent\Relations\MorphToOne
*/
public function featuredImage()
{
return $this->morphToOne(Image::class, 'imageable')
->wherePivot('featured', 1);
//->withDefault();
}
/**
* Get all images including the featured.
*
* @return \Illuminate\Database\Eloquent\Relations\MorphToMany
*/
public function images()
{
return $this->morphToMany(Image::class, 'imageable')
->withPivot('featured');
}
}
Now you can access the relationship like:
// eager loading
$post = Post::with('featuredImage')->first();
dump($post->featuredImage);
// lazy loading
$post->load('featuredImage');
Testing
composer test
Security
If you discover any security related issues, please email pro.ankurk1[at]gmail[dot]com
instead of using the issue tracker.
Attribution
Most of the code is taken from this PR
License
The MIT License.