signifly/laravel-pivot-events

Trigger Eloquent model pivot events when attaching, detaching or updating.

Easily add Eloquent model pivot events to your Laravel app

, _(*1)

The signifly/laravel-pivot-events package allows you to easily add Eloquent model pivots events to your Laravel app., _(*2)

Below is a small example of how to use it., _(*3)

// Remember to add use statement
use Signifly\PivotEvents\HasPivotEvents;

class User
{
    use HasPivotEvents;
}

Now you would be able to listen for the newly available pivot events:, _(*4)

use Signifly\PivotEvents\HasPivotEvents;

class User
{
    use HasPivotEvents;

    protected static function boot()
    {
        static::pivotAttaching(function ($model) {
            // To get related changes
            $model->getPivotChanges();
            // return Collection(['attach' => ['roles' => [1 => ['scopes' => 'orders']]]])

            // To get related changes for a specific type
            $model->getPivotChanges('attach');
            // return Collection(['roles' => [1 => ['scopes' => 'orders']]])

            // You can get nested changes
            // values are $id => $attributes
            $model->getPivotChanges('attach.roles');
            // return Collection([1 => ['scopes' => 'orders']])

            // To get related ids for a specific type and relation
            $model->getPivotChangeIds('attach', 'roles');
            // return Collection([1])
        });

        static::pivotAttached(function ($model) {
            //
        });

        static::pivotDetaching(function ($model) {
            //
        });

        static::pivotDetached(function ($model) {
            //
        });

        static::pivotUpdating(function ($model) {
            //
        });

        static::pivotUpdated(function ($model) {
            //
        });
    }
}

You can also use observers for the available events: pivotAttaching, pivotAttached, pivotDetaching, pivotDetached, pivotUpdating, pivotUpdated., _(*5)

Documentation

Until further documentation is provided, please have a look at the tests., _(*6)

Installation

You can install the package via composer:, _(*7)

$ composer require signifly/laravel-pivot-events

The package will automatically register itself., _(*8)

Testing

$ composer test

Security

If you discover any security issues, please email dev@signifly.com instead of using the issue tracker., _(*9)

Credits

• Morten Poul Jensen
• Travis Elkins
• All contributors

License

The MIT License (MIT). Please see License File for more information., _(*10)