Lors du d\u00e9veloppement sur un projet Web, vous pourriez avoir besoin que quelque chose se produise lorsqu’une table de la base de donn\u00e9es est modifi\u00e9e. Par exemple, vous pourriez vouloir envoyer une notification de confirmation \u00e0 un utilisateur chaque fois qu’un enregistrement est cr\u00e9\u00e9. Ou vous pourriez vouloir cr\u00e9er un enregistrement dans une table de journal chaque fois qu’un enregistrement est mis \u00e0 jour ou supprim\u00e9. Ou vous pourriez vouloir assainir vos donn\u00e9es avant qu’elles ne soient envoy\u00e9es \u00e0 la base de donn\u00e9es et supprimer toutes les balises html ou script.<\/p>
Bien que vous puissiez le faire dans vos m\u00e9thodes de contr\u00f4leur, il y a de fortes chances que vous manipuliez une table \u00e0 plusieurs endroits, et que vous devriez maintenir aussi ce code \u00e0 plusieurs endroits. Une fa\u00e7on plus efficace de proc\u00e9der est de placer le code dans les \u00e9v\u00e9nements int\u00e9gr\u00e9s de Laravel.<\/p>
Laravel comprend un certain nombre d’\u00e9v\u00e9nements qui se d\u00e9clenchent pendant la dur\u00e9e de vie d’un mod\u00e8le. Ces \u00e9v\u00e9nements correspondent \u00e0 diff\u00e9rentes actions effectu\u00e9es sur une table de base de donn\u00e9es. Ces \u00e9v\u00e9nements comprennent la cr\u00e9ation d’un enregistrement : la mise \u00e0 jour d’un enregistrement, l’enregistrement (qui est d\u00e9clench\u00e9 en tant que partie de la cr\u00e9ation ou de la mise \u00e0 jour) et la suppression.<\/p>
Il y a en fait deux \u00e9v\u00e9nements qui se d\u00e9clenchent pour chacun de ces \u00e9v\u00e9nements ; un \u00e9v\u00e9nement se produit avant que l’action ne se produise, et l’autre se produit apr\u00e8s qu’elle se soit produite. Par exemple, l’\u00e9v\u00e9nement de cr\u00e9ation se d\u00e9clenche avant que l’enregistrement ne soit cr\u00e9\u00e9 dans la base de donn\u00e9es, tandis que l’\u00e9v\u00e9nement de cr\u00e9ation se d\u00e9clenche une fois que l’enregistrement a \u00e9t\u00e9 cr\u00e9\u00e9. La liste compl\u00e8te ressemble \u00e0 ceci :<\/p>
Remarque : l’ex\u00e9cution d’une mise \u00e0 jour ou d’une suppression de masse (par exemple – User::where(‘active’, ‘=’, 0)->delete();) ne d\u00e9clenchera pas<\/strong> d’\u00e9v\u00e9nement, car les mod\u00e8les ne sont pas r\u00e9ellement r\u00e9cup\u00e9r\u00e9s dans ces cas-l\u00e0. Dans ce cas, vous pourriez vouloir r\u00e9cup\u00e9rer les enregistrements et les parcourir en boucle pour effectuer la mise \u00e0 jour\/suppression.<\/p> Il existe plusieurs fa\u00e7ons de se connecter \u00e0 ces \u00e9v\u00e9nements ; ci-dessous, nous examinerons deux des plus courantes : les fermetures (closures) et les observateurs (observers).<\/p> Les mod\u00e8les Eloquent ont une m\u00e9thode statique d\u00e9finie pour chaque \u00e9v\u00e9nement (cr\u00e9ation, mise \u00e0 jour, suppression etc), qui peut \u00eatre utilis\u00e9e pour enregistrer des fermetures pour chaque \u00e9v\u00e9nement. Ces fermetures sont d\u00e9finies dans la m\u00e9thode booted du mod\u00e8le.<\/p> Nous allons prendre l’exemple d’une simple table utilis\u00e9e pour stocker les rendez-vous. Lorsqu’un rendez-vous est cr\u00e9\u00e9, nous voulons envoyer une AppointmentNotification (qui, nous le supposons, a d\u00e9j\u00e0 \u00e9t\u00e9 cr\u00e9\u00e9e dans le syst\u00e8me) \u00e0 l’utilisateur associ\u00e9 au rendez-vous.<\/p> use App\\Notifications\\AppointmentNotification; Dans l’exemple ci-dessus, vous remarquerez que nous avons ajout\u00e9 cette ligne \u00e0 la m\u00e9thode booted de la classe Appointment :<\/p> Cela indique \u00e0 Laravel qu’apr\u00e8s la cr\u00e9ation d’un rendez-vous, nous voulons r\u00e9cup\u00e9rer l’utilisateur associ\u00e9 au rendez-vous, puis envoyer une notification \u00e0 cet utilisateur.<\/p> Si vous d\u00e9sirez ex\u00e9cuter le code en arri\u00e8re-plan, vous pouvez enregistrer l’\u00e9v\u00e9nement comme pouvant \u00eatre mis en file d’attente. Cela ex\u00e9cutera l’\u00e9couteur d’\u00e9v\u00e9nement dans la file d’attente de l’application :<\/p> Si vous avez besoin d’\u00e9couter plusieurs \u00e9v\u00e9nements sur un mod\u00e8le, vous pouvez les regrouper \u00e0 l’aide d’un observateur. Un observateur est un objet qui poss\u00e8de des m\u00e9thodes pour chacun des \u00e9v\u00e9nements du mod\u00e8le, chacune d’entre elles recevant le mod\u00e8le affect\u00e9 en tant qu’argument. Les observateurs sont cr\u00e9\u00e9s \u00e0 l’aide d’une commande Artisan :<\/p> php artisan make:observer AppointmentObserver –model=User<\/p> Cette commande cr\u00e9e un nouvel observateur dans le r\u00e9pertoire app\/Observers. Lors de sa premi\u00e8re cr\u00e9ation, l’observateur ressemblera \u00e0 quelque chose comme ceci :<\/p> Nous pouvons maintenant ajouter notre code pour envoyer la notification de rendez-vous \u00e0 la m\u00e9thode created :<\/p> Une fois l’observateur cr\u00e9\u00e9, vous devrez l’enregistrer dans la m\u00e9thode boot<\/strong> de la classe App\\Providers\\EventServiceProvider<\/strong> pour commencer \u00e0 \u00e9couter les \u00e9v\u00e9nements.<\/p> Vous pouvez \u00e9galement dresser la liste des observateurs dans la propri\u00e9t\u00e9 observers<\/strong> de la classe App\\Providers\\EventServiceProvider<\/strong>.<\/p> Il peut arriver que vous ayez besoin d’ex\u00e9cuter une commande sur le mod\u00e8le sans d\u00e9clencher d’\u00e9v\u00e9nements ; il y a plusieurs fa\u00e7ons de le faire. La m\u00e9thode withoutEvents<\/strong> accepte une fermeture comme argument ; tout code ex\u00e9cut\u00e9 \u00e0 l’int\u00e9rieur de cette fermeture ne d\u00e9clenchera pas d’\u00e9v\u00e9nement.<\/p> L’utilisation de withoutEvents<\/strong> est pratique si vous modifiez plusieurs enregistrements ou si vous effectuez plusieurs actions sur un mod\u00e8le. Si vous devez ex\u00e9cuter une seule action sur un mod\u00e8le, vous pouvez utiliser des m\u00e9thodes comme saveQuietly<\/strong>, deleteQuietly<\/strong>, forceDeleteQuietly<\/strong> et restoreQuietly.<\/strong><\/p> Nous esp\u00e9rons que cela a permis de clarifier le r\u00f4le des observateurs dans Laravel, et que vous avez d\u00e9sormais une meilleure id\u00e9e de quand et comment les utiliser. Si vous avez un projet Laravel en t\u00eate, nous serions ravis de vous aider. Envoyez-nous un message<\/a> et nous prendrons contact avec vous.<\/p>","protected":false},"excerpt":{"rendered":" Lors du d\u00e9veloppement sur un projet Web, vous pourriez avoir besoin que quelque chose se produise lorsqu’une table de la base de donn\u00e9es est modifi\u00e9e. Par exemple, vous pourriez vouloir envoyer une notification de confirmation \u00e0 un utilisateur chaque fois qu’un enregistrement est cr\u00e9\u00e9. Ou vous pourriez vouloir cr\u00e9er un enregistrement dans une table de …<\/p>\nFermetures<\/h3>
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>Observateurs<\/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>Mise en sourdine des \u00e9v\u00e9nements<\/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>