Qu’est-ce qu’une Notification
Le système de Notification de Laravel permet d’envoyer des notifications via plusieurs canaux (mail, SMS, Slack, base…) avec une API unifiée.
Différences Mail vs Notification
| Comparaison | Mail | Notification |
|---|
| Usage principal | E-mail HTML riche | Message d’information court |
| Canaux | Mail uniquement | Mail, DB, Slack, SMS, etc. |
| Templates | Totalement libres | Format de message simple |
Créer une Notification
Utilisez make:notification.
php artisan make:notification InvoicePaid
app/Notifications/. Il expose via() et les méthodes de génération de message par canal.
Envoi
Trait Notifiable
App\Models\User inclut le trait Notifiable par défaut. Envoyez avec notify().
use App\Notifications\InvoicePaid;
$user->notify(new InvoicePaid($invoice));
Notifiable peut être ajouté à n’importe quel modèle, pas seulement User.
Façade Notification
Pour plusieurs destinataires simultanément :
use Illuminate\Support\Facades\Notification;
Notification::send($users, new InvoicePaid($invoice));
Notification::sendNow($developers, new DeploymentCompleted($deployment));
Spécifier les canaux
via() retourne les canaux à utiliser.
public function via(object $notifiable): array
{
return ['mail', 'database'];
}
public function via(object $notifiable): array
{
return $notifiable->prefers_sms ? ['vonage'] : ['mail', 'database'];
}
| Canal | Clé | Description |
|---|
| E-mail | mail | Envoi par e-mail |
| Base de données | database | Enregistrement pour affichage dans l’UI |
| Broadcast | broadcast | Notification temps réel (WebSocket) |
| SMS | vonage | SMS via Vonage (ex-Nexmo) |
| Slack | slack | Publication dans un salon Slack |
Canal e-mail
toMail() retourne un MailMessage.
use Illuminate\Notifications\Messages\MailMessage;
public function toMail(object $notifiable): MailMessage
{
$url = url('/invoice/'.$this->invoice->id);
return (new MailMessage)
->greeting('Bonjour !')
->line('Votre paiement a été confirmé.')
->action('Voir la facture', $url)
->line('Merci pour votre confiance.');
}
| Méthode | Description |
|---|
greeting() | Salutation d’introduction |
line() | Une ligne de corps |
action() | Bouton d’action |
subject() | Sujet |
from() | Adresse de l’expéditeur |
mailer() | Mailer à utiliser |
error() colore le bouton en rouge.
return (new MailMessage)
->error()
->subject('Échec du paiement')
->line('Le traitement du paiement a échoué.');
E-mails en Markdown
Générez avec --markdown.
php artisan make:notification InvoicePaid --markdown=mail.invoice.paid
markdown() dans toMail.
use Illuminate\Notifications\Messages\MailMessage;
public function toMail(object $notifiable): MailMessage
{
return (new MailMessage)
->markdown('mail.invoice.paid', [
'url' => url('/invoice/'.$this->invoice->id),
'invoice' => $this->invoice,
]);
}
Canal base de données
Le canal database enregistre les notifications en base, pour affichage dans votre UI.
Table
php artisan make:notifications-table
php artisan migrate
toArray()
public function toArray(object $notifiable): array
{
return [
'invoice_id' => $this->invoice->id,
'amount' => $this->invoice->amount,
'message' => 'Paiement confirmé.',
];
}
data de notifications.
Lire les notifications
Via la relation notifications du trait.
$user = App\Models\User::find(1);
foreach ($user->notifications as $notification) {
echo $notification->type;
echo $notification->data['message'];
}
foreach ($user->unreadNotifications as $notification) {
echo $notification->data['message'];
}
Marquer comme lues
foreach ($user->unreadNotifications as $notification) {
$notification->markAsRead();
}
$user->unreadNotifications->markAsRead();
$user->unreadNotifications()->update(['read_at' => now()]);
Notifications en queue
Pour les traitements longs, implémentez ShouldQueue et utilisez le trait Queueable. Ils sont inclus par défaut par make:notification.
<?php
namespace App\Notifications;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Notifications\Notification;
class InvoicePaid extends Notification implements ShouldQueue
{
use Queueable;
// ...
}
notify() met alors automatiquement en file.
$user->notify(new InvoicePaid($invoice));
$user->notify(
(new InvoicePaid($invoice))->delay(now()->plus(minutes: 10))
);
Envoi vers plusieurs canaux
Il suffit de retourner plusieurs canaux dans via() et de définir les méthodes correspondantes.
<?php
namespace App\Notifications;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Notifications\Messages\MailMessage;
use Illuminate\Notifications\Notification;
class InvoicePaid extends Notification implements ShouldQueue
{
use Queueable;
public function __construct(
private readonly Invoice $invoice,
) {}
public function via(object $notifiable): array
{
// Mail + base
return ['mail', 'database'];
}
public function toMail(object $notifiable): MailMessage
{
return (new MailMessage)
->subject('Paiement confirmé')
->line('Paiement de la facture #'.$this->invoice->id.' confirmé.')
->action('Voir la facture', url('/invoice/'.$this->invoice->id));
}
public function toArray(object $notifiable): array
{
return [
'invoice_id' => $this->invoice->id,
'amount' => $this->invoice->amount,
];
}
}
Notifications à la demande
Pour envoyer à quelqu’un sans compte : Notification::route().
use Illuminate\Support\Facades\Notification;
Notification::route('mail', '[email protected]')
->route('vonage', '5555551212')
->notify(new InvoicePaid($invoice));
Récapitulatif
| Objectif | Méthode |
|---|
| Créer une Notification | php artisan make:notification ClassName |
| Notifier un utilisateur | $user->notify(new MyNotification()) |
| Notifier plusieurs utilisateurs | Notification::send($users, new MyNotification()) |
| Envoyer par mail | via() retourne mail + toMail() |
| Enregistrer en base | via() retourne database + toArray() |
| Envoyer en queue | Implémenter ShouldQueue |
| Multi-canal | via() retourne plusieurs clés |
