haganjones / laravel-observe-properties
A simple trait to allow you to observe changing properties on a Model.
Requires
- php: >=5.6.0
Requires (Dev)
- mockery/mockery: 0.9.*
- orchestra/database: 3.3.*
- orchestra/testbench: 3.3.*
- phpunit/phpunit: ~6.0
This package is auto-updated.
Last update: 2024-10-10 05:42:02 UTC
README
A simple trait to allow you to observe changing properties on a Model.
When observing a model it is sometimes necessary to check to see if a particular property on a model has changed, then perform an action. If you need to do this a lot then your observer methods can soon become clogged up, hopefully this trait will help you out!
Install via Composer
composer require "haganjones/laravel-observe-properties"
To Use
Include the trait in your Observation Classes:
<?php namespace App\Observers; use HaganJones\LaravelObserveProperties\ObserveProperties; class UserObserver { use ObserveProperties; }
Including this trait in your class allows you to make use of the camelcaseProperty + Eventname
methods.
For example, following on from our UserObserver
class above:
// Inside UserObserver Class public function emailUpdated(User $user, $oldValue, $newValue) { $format = 'User %d changed their email from %s to %s'; Log::info(sprintf($format, $user->id, $oldValue, $newValue)); // User 1 changed their email from oldrusty@example.org to newshiny@example.org }
Available Events
All default Laravel Events are supported, please not some events will only receive one value. See below for full list of events and arguments.
Caveats
As per the Laravel docs the Saving|Saved
events fire along
side Creating|Created
and Updating|Updated
methods.
With this in mind when creating a Model the Saving|Saved
event will receive
both $oldValue
and $newValue
arguments but they will have the
same value.
Using in existing Observer classes.
It is possible you would want to add this functionality inside your existing Observer classes in this case you will need to include the trait but give it's methods some aliases e.g
<?php namespace App\Observers; use HaganJones\LaravelObserveProperties\ObserveProperties; use App\User; class UserObserver { use ObserveProperties { updating as updatingProperties; //add in other method aliases here. } public function updating(User $user) { //Do things with $user return $this->updatingProperties($user); } public function firstNameUpdating(User $user, $oldValue, $newValue) { //$user->first_name was just updated. } }