PHPackages                             jpkleemans/attribute-events - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database & ORM](/categories/database)
4. /
5. jpkleemans/attribute-events

ActiveLibrary[Database & ORM](/categories/database)

jpkleemans/attribute-events
===========================

🔥 Fire events on attribute changes of your Eloquent model

1.5.1(1y ago)332484.7k—1.1%22[2 issues](https://github.com/jpkleemans/attribute-events/issues)1MITPHPPHP ^7.3|^8.0CI passing

Since Jun 24Pushed 3mo ago5 watchersCompare

[ Source](https://github.com/jpkleemans/attribute-events)[ Packagist](https://packagist.org/packages/jpkleemans/attribute-events)[ Docs](https://attribute.events/)[ GitHub Sponsors](https://github.com/jpkleemans)[ RSS](/packages/jpkleemans-attribute-events/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (4)Versions (13)Used By (1)

[![Laravel Attribute Events](/../gh-pages/attribute-events.svg#gh-light-mode-only)](/../gh-pages/attribute-events.svg#gh-light-mode-only)[![Laravel Attribute Events](/../gh-pages/attribute-events-dark.svg#gh-dark-mode-only)](/../gh-pages/attribute-events-dark.svg#gh-dark-mode-only)

 [![Build Status](https://camo.githubusercontent.com/2597a91cc5b716febbc6aaad6f0e5c5c49df568eb5d955d2d301f187485d582e/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f636f6d2f6a706b6c65656d616e732f6174747269627574652d6576656e74733f6c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://app.travis-ci.com/jpkleemans/attribute-events) [![Last Updated](https://camo.githubusercontent.com/9428878f6a3d54a8c12352ebbda4bc27392ca863b026b5c70fe2b2ec22428a99/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f6a706b6c65656d616e732f6174747269627574652d6576656e74733f6c6162656c3d75706461746564267374796c653d666c61742d737175617265)](https://github.com/jpkleemans/attribute-events/commits) [![Latest Stable Version](https://camo.githubusercontent.com/eca798bd98aa6f1deca7ce70259605dc0ac6a80e022f35e8086ba4292d224d84/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6a706b6c65656d616e732f6174747269627574652d6576656e74733f6c6162656c3d737461626c65267374796c653d666c61742d737175617265)](https://packagist.org/packages/jpkleemans/attribute-events) [![License](https://camo.githubusercontent.com/e0f8996d10680690dcaad74a783b56a7dc22fd935f6236ec589d54b11af974f0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6a706b6c65656d616e732f6174747269627574652d6576656e74733f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jpkleemans/attribute-events)

```
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
------------

[](#installation)

```
composer require jpkleemans/attribute-events
```

How to use it
-------------

[](#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](https://laravel.com/docs/eloquent#events)

Listening
---------

[](#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](https://laravel.com/docs/broadcasting) feature:

```
Echo.channel('orders')
    .listen('OrderShipped', (event) => {
        // Display a notification
    })
```

JSON attributes
---------------

[](#json-attributes)

For attributes stored as JSON, you can use the `->` operator:

```
protected $dispatchesEvents = [
    'payment->status:completed' => PaymentCompleted::class,
];
```

Accessors
---------

[](#accessors)

For more complex state changes, you can use attributes defined by an [accessor](https://laravel.com/docs/eloquent-mutators#defining-an-accessor):

```
class Product extends Model
{
    protected $dispatchesEvents = [
        'low_stock:true' => ProductReachedLowStock::class,
    ];

    public function getLowStockAttribute(): bool
    {
        return $this->stock  You can also use the [new way of defining accessors](https://laravel.com/docs/9.x/releases#eloquent-accessors-and-mutators) introduced in Laravel 9.

Learn more
----------

[](#learn-more)

- [“Decouple your Laravel code using Attribute Events”](https://jpkleemans.medium.com/decouple-your-laravel-code-using-attribute-events-de8f2528f46a) by Jan-Paul Kleemans
- [Laravel Docs on Model Events](https://laravel.com/docs/eloquent#events)

Sponsors
--------

[](#sponsors)

[ ![Nexxtmove Logo](https://raw.githubusercontent.com/jpkleemans/attribute-events/gh-pages/nexxtmove-logo.svg)](https://www.nexxtmove.nl/)Thanks to [Nexxtmove](https://www.nexxtmove.nl/) for sponsoring the development of this project.
Your logo or name here? [Sponsor this project](https://github.com/sponsors/jpkleemans).

License
-------

[](#license)

Code released under the [MIT License](https://github.com/jpkleemans/attribute-events/blob/master/LICENSE).

###  Health Score

57

—

FairBetter than 98% of packages

Maintenance67

Regular maintenance activity

Popularity55

Moderate usage in the ecosystem

Community23

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 96.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~162 days

Recently: every ~295 days

Total

12

Last Release

367d ago

Major Versions

0.2.0 → 1.0.02020-07-07

### Community

Maintainers

![](https://www.gravatar.com/avatar/3b4ef8e7738c77130e1cc63ff7f0503e25c5757145c9ac17cfabc380cba37143?d=identicon)[jpkleemans](/maintainers/jpkleemans)

---

Top Contributors

[![jpkleemans](https://avatars.githubusercontent.com/u/5700014?v=4)](https://github.com/jpkleemans "jpkleemans (203 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)")[![DennyLoko](https://avatars.githubusercontent.com/u/635014?v=4)](https://github.com/DennyLoko "DennyLoko (1 commits)")[![ariaieboy](https://avatars.githubusercontent.com/u/15873972?v=4)](https://github.com/ariaieboy "ariaieboy (1 commits)")[![ee-bhushan](https://avatars.githubusercontent.com/u/88677237?v=4)](https://github.com/ee-bhushan "ee-bhushan (1 commits)")[![bhushan](https://avatars.githubusercontent.com/u/43483545?v=4)](https://github.com/bhushan "bhushan (1 commits)")[![maartenpaauw](https://avatars.githubusercontent.com/u/4550875?v=4)](https://github.com/maartenpaauw "maartenpaauw (1 commits)")

---

Tags

accessorsattributesddddomain-driven-designdomain-eventsdomain-modeleloquentevent-driven-architectureevent-stormingeventslaravelmodel-eventslaraveleventseloquentattributesddddomain-eventsmodel events

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/jpkleemans-attribute-events/health.svg)

```
[![Health](https://phpackages.com/badges/jpkleemans-attribute-events/health.svg)](https://phpackages.com/packages/jpkleemans-attribute-events)
```

###  Alternatives

[mvanduijker/laravel-transactional-model-events

Add eloquent model events fired after a transaction is committed or rolled back

75164.5k](/packages/mvanduijker-laravel-transactional-model-events)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)