During development on a web project, you may need something to occur when a database table is modified. For example, you might want to send a confirmation notification to a user whenever a record is created. Or you might want to create a record in a log table whenever a record is updated or deleted. Or you might want to sanitize your data before it is sent to the database and strip out any html or script tags.<\/p>
While you could do this in your controller methods, chances are that you are manipulating a table in multiple places, so you would have to maintain that code in multiple places. A more efficient way to do this is to place the code in Laravel’s built-in events.<\/p>
Laravel includes a number of events that are triggered during the lifetime of a model. These events correspond to different actions performed on a database table. These events include record creation: updating a record, saving (which is triggered as part creation or updating), and deleting.<\/p>
There are actually two events that trigger for each of these events; one event occurs before the action occurs, and the other happens after it occurs. For example, the creating event fires before the record is created in the database, while the created event fires once the record has been created. The full list looks something like this:<\/p>
Note: performing a mass update or delete (for example – User::where(‘active’, ‘=’, 0)->delete();) will not<\/strong> trigger an event, since the models are not actually retrieved in these cases. In this case, you might want to retrieve the records and then loop through them to perform the update\/delete.<\/p> There are a few ways to tie into these events; below we’ll look at two of the most common\u2014closures and observers.<\/p> Eloquent models have a static method defined for each event (created, updated, deleted, etc.), which can be used to register closures for each event. These closures are defined in the model’s booted method.<\/p> We’ll use the example of a simple table used to store appointments. When an appointment is created, we want to send an AppointmentNotification (which we’ll assume has already been created in the system) to the User associated with the Appointment.<\/p> use App\\Notifications\\AppointmentNotification; In the example above, you\u2019ll notice that we added this line to the booted method of the appointment class:<\/p> This tells Laravel that after an appointment has been created, we want to retrieve the user associated with the Appointment, then send an Appointment Notification to that user.<\/p> If you want to run the code in the background, you can register the event as queueable. This will execute the event listener in the application’s queue:<\/p> If you need to listen for multiple events on a model, you might want to group them together using an observer. An observer is an object that has methods for each of the model events, each of which receives the affected model as an argument. Observers are created with an Artisan command:<\/p> php artisan make:observer AppointmentObserver –model=User<\/p> This command creates a the new observer in the app\/Observers directory. When first created, the observer will look like something like this:<\/p> We can now add our code for sending the Appointment Notification to the created method:<\/p> Once the observer is created, you will need to register it in the boot<\/strong> method of the App\\Providers\\EventServiceProvider<\/strong> class to start listening for events.<\/p> Alternately, you can list the observers in the $observers<\/strong> property of the App\\Providers\\EventServiceProvider<\/strong> class.<\/p> Occasionally, you might need to run a command on the model without triggering any events; there are a couple ways to do this. The withoutEvents<\/strong> method accepts a closure as its argument; any code run inside this close will not trigger an event.<\/p> Using withoutEvents<\/strong> is convenient if you are modifying multiple records, or performing multiple actions on a model. If you need to run a single action on a model, you can use use methods like saveQuietly<\/strong>, deleteQuietly<\/strong>, forceDeleteQuietly<\/strong> and restoreQuietly.<\/strong><\/p> We hope that this helps to clarify the role of observers in Laravel, and that you have a better idea of when and how to use them. If you have a Laravel project in mind, we would be happy to assist. Send us a note<\/a> and we\u2019ll be in touch.<\/p>","protected":false},"excerpt":{"rendered":" During development on a web project, you may need something to occur when a database table is modified. For example, you might want to send a confirmation notification to a user whenever a record is created. Or you might want to create a record in a log table whenever a record is updated or deleted. …<\/p>\nClosures<\/h3>
use Illuminate\\Database\\Eloquent\\Factories\\HasFactory;
use Illuminate\\Database\\Eloquent\\Model;<\/p>use App\\Notifications\\AppointmentNotification;\nuse Illuminate\\Database\\Eloquent\\Factories\\HasFactory;\nuse Illuminate\\Database\\Eloquent\\Model;\n\nclass Appointment extends Model\n{\n use HasFactory;\n\n \/\/ ***********************************\n #region Booted\n \/\/ ***********************************\n protected static function booted() {\n parent::booted();\n\n static::created(function (Appointment $appointment) {\n $appointment->user()->notify(new AppointmentNotification($appointment));\n });\n }\n #endregion\n\n \/\/ ***********************************\n #region Relationships\n \/\/ ***********************************\n public function user() {\n return $this->belongsTo(User::class);\n }\n #endregion\n}<\/code><\/pre> $appointment->user()->notify(new AppointmentNotification($appointment));<\/code><\/pre>use function Illuminate\\Events\\queueable;\n\n\/\/...\n\nstatic::created(queueable(function (Appointment $appointment) {\n \/\/ ...\n}));<\/code><\/pre>Observers<\/h3>
use App\\Models\\Appointment;\n\nclass AppointmentObserver\n{\n \/**\n * Handle the Appointment \"created\" event.\n *\/\n public function created(Appointment $appointment): void\n {\n \/\/ ...\n }\n\n \/**\n * Handle the Appointment \"updated\" event.\n *\/\n public function updated(Appointment $appointment): void\n {\n \/\/ ...\n }\n \n \/**\n * Handle the Appointment \"deleted\" event.\n *\/\n public function deleted(Appointment $appointment): void\n {\n \/\/ ...\n }\n}<\/code><\/pre>use App\\Notifications\\AppointmentNotification;\n...\n\npublic function created(Appointment $appointment): void\n{\n $appointment->user()->notify(new AppointmentNotification($appointment));\n}<\/code><\/pre>use App\\Models\\Appointment;\nuse App\\Observers\\AppointmentObserver;\n\n\/**\n\nRegister any events for your application.\n*\/\npublic function boot(): void\n{\n Appointment::observe(AppointmentObserver::class);\n}<\/code><\/pre>use App\\Models\\Appointment;\nuse App\\Observers\\AppointmentObserver;\n\n \/**\n\nThe model observers for your application.\n\n@var array\n*\/\nprotected $observers = [\n Appointment::class => [AppointmentObserver::class],\n];<\/code><\/pre>Muting Events<\/h3>
use App\\Models\\Appointment\n\n$appointment = Appointment::withoutEvents(function() {\n $appointment = Appointment::findOrFail(1)->update['cancelled=>true]);\n ....\n return $appoitnment\n});<\/code><\/pre>$appointment = Appointment::findOrFail(1);\n$appointment->cancelled = true;\n$appointment->saveQuietly();<\/code><\/pre>Conclusion<\/h2>