Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ankurk91/laravel-eloquent-relationships
Add some more eloquent relationships to Laravel php framework. :couple:
https://github.com/ankurk91/laravel-eloquent-relationships
belongs-to-one eloquent laravel relationships
Last synced: about 16 hours ago
JSON representation
Add some more eloquent relationships to Laravel php framework. :couple:
- Host: GitHub
- URL: https://github.com/ankurk91/laravel-eloquent-relationships
- Owner: ankurk91
- License: mit
- Created: 2019-01-05T08:56:28.000Z (about 6 years ago)
- Default Branch: main
- Last Pushed: 2024-11-25T10:50:54.000Z (about 2 months ago)
- Last Synced: 2025-01-08T15:14:56.879Z (8 days ago)
- Topics: belongs-to-one, eloquent, laravel, relationships
- Language: PHP
- Homepage: https://packagist.org/packages/ankurk91/laravel-eloquent-relationships
- Size: 140 KB
- Stars: 57
- Watchers: 3
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Missing Eloquent Relationships For Laravel
[](https://packagist.org/packages/ankurk91/laravel-eloquent-relationships)
[](https://github.com/ankurk91/laravel-eloquent-relationships/tags)
[](LICENSE.txt)
[](https://packagist.org/packages/ankurk91/laravel-eloquent-relationships/stats)
[](https://github.com/ankurk91/laravel-eloquent-relationships/actions)
[](https://codecov.io/gh/ankurk91/laravel-eloquent-relationships)
This package adds some missing relationships to Eloquent in Laravel
## Installation
You can install the package via composer:
```bash
composer require ankurk91/laravel-eloquent-relationships
```
## Usage
### BelongsToOne
BelongsToOne relation is almost identical to
standard [BelongsToMany](https://laravel.com/docs/9.x/eloquent-relationships#many-to-many) 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
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
first();
dump($restaurant->operator);
// lazy loading
$restaurant->load('operator');
// load nested relation
$restaurant->load('operator.profile');
// Perform operations
$restaurant->operator()->update([
'name'=> 'Taylor'
]);
```
### MorphToOne
MorphToOne relation is almost identical to
standard [MorphToMany](https://laravel.com/docs/9.x/eloquent-relationships#many-to-many-polymorphic-relations) 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
morphedByMany(Post::class, 'imageable');
}
public function videos(): MorphToMany
{
return $this->morphedByMany(Video::class, 'imageable');
}
}
```
```php
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
first();
dump($post->featuredImage);
// lazy loading
$post->load('featuredImage');
```
## Testing
```bash
composer test
```
## Security
If you discover any security 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](https://github.com/laravel/framework/pull/25083)
* Similar package [fidum/laravel-eloquent-morph-to-one](https://github.com/fidum/laravel-eloquent-morph-to-one)
## License
The [MIT](https://opensource.org/licenses/MIT) License.