jpkleemans / attribute-events
🔥 Fire events on attribute changes of your Eloquent model
Fund package maintenance!
jpkleemans
Installs: 323 204
Dependents: 1
Suggesters: 0
Security: 0
Stars: 310
Watchers: 6
Forks: 21
Open Issues: 3
Requires
- php: ^7.3|^8.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.41
- illuminate/database: ^10.37
- illuminate/events: ^10.37
- phpunit/phpunit: ^10.5
README
class Order extends Model { protected $dispatchesEvents = [ 'status:shipped' => OrderShipped::class, 'note:*' => OrderNoteChanged::class, ]; }
Eloquent models fire several handy events throughout their lifecycle, like created
and deleted
. However, there are usually many more business meaningful events that happen during a model's life. With this library you can capture those, by mapping attribute changes to your own event classes.
Installation
composer require jpkleemans/attribute-events
How to use it
Use the Kleemans\AttributeEvents
trait in your model and add the attributes to the $dispatchesEvents
property:
class Order extends Model { use AttributeEvents; protected $dispatchesEvents = [ 'created' => OrderPlaced::class, 'status:canceled' => OrderCanceled::class, 'note:*' => OrderNoteChanged::class, ]; }
The attribute events will be dispatched after the updated model is saved. Each event receives the instance of the model through its constructor.
For more info on model events and the
$dispatchesEvents
property, visit the Laravel Docs
Listening
Now you can subscribe to the events via the EventServiceProvider
$listen
array, or manually with Closure based listeners:
Event::listen(function (OrderCanceled $event) { // Restock inventory });
Or push realtime updates to your users, using Laravel's broadcasting feature:
Echo.channel('orders') .listen('OrderShipped', (event) => { // Display a notification })
JSON attributes
For attributes stored as JSON, you can use the ->
operator:
protected $dispatchesEvents = [ 'payment->status:completed' => PaymentCompleted::class, ];
Accessors
For more complex state changes, you can use attributes defined by an accessor:
class Product extends Model { protected $dispatchesEvents = [ 'low_stock:true' => ProductReachedLowStock::class, ]; public function getLowStockAttribute(): bool { return $this->stock <= 3; } }
You can also use the new way of defining accessors introduced in Laravel 9.
Learn more
- “Decouple your Laravel code using Attribute Events” by Jan-Paul Kleemans
- Laravel Docs on Model Events
Sponsors
Thanks to Nexxtmove for sponsoring the development of this project.
Your logo or name here? Sponsor this project.
License
Code released under the MIT License.