> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.
# Envoi d'e-mails
> Envoi d'e-mails avec les classes Mailable de Laravel : bases, e-mails Markdown et envoi via queue.
## La fonctionnalité de mail de Laravel
La fonctionnalité mail est basée sur [Symfony Mailer](https://symfony.com/doc/current/mailer.html) et prend en charge SMTP, Mailgun, Postmark, Resend, Amazon SES, sendmail, etc.
SwiftMailer, utilisé dans les anciennes versions, est abandonné. Depuis Laravel 9, c'est Symfony Mailer.
La configuration se trouve dans `config/mail.php`. Changez le driver via `.env`.
```ini theme={null}
MAIL_MAILER=smtp
MAIL_HOST=smtp.example.com
MAIL_PORT=587
MAIL_USERNAME=your-username
MAIL_PASSWORD=your-password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS="hello@example.com"
MAIL_FROM_NAME="${APP_NAME}"
```
## Créer une classe Mailable
Chaque e-mail est représenté par une classe « Mailable ». Utilisez `make:mail`.
```shell theme={null}
php artisan make:mail OrderShipped
```
Le fichier est créé dans `app/Mail/`.
## Configurer un Mailable
La classe générée expose `envelope()`, `content()` et `attachments()`.
```php theme={null}
[
'address' => env('MAIL_FROM_ADDRESS', 'hello@example.com'),
'name' => env('MAIL_FROM_NAME', 'Example'),
],
```
### Définir le contenu
Dans `content()`, précisez le template Blade. Les propriétés `public` définies dans le constructeur sont automatiquement disponibles dans le template.
```php theme={null}
public function content(): Content
{
return new Content(
view: 'mail.orders.shipped',
);
}
```
Créez le template `resources/views/mail/orders/shipped.blade.php`.
```blade theme={null}
Votre commande a été expédiée
N° de commande : {{ $order->id }}
Montant total : {{ number_format($order->total) }} €
Merci pour votre achat.
```
Vous pouvez aussi passer explicitement les données via `with`. Les propriétés peuvent alors être `protected` ou `private`.
```php theme={null}
public function __construct(
protected Order $order,
) {}
public function content(): Content
{
return new Content(
view: 'mail.orders.shipped',
with: [
'orderId' => $this->order->id,
'total' => $this->order->total,
],
);
}
```
## Envoyer un e-mail
Utilisez la façade `Mail`, indiquez le destinataire avec `to()` puis `send()`.
```mermaid theme={null}
flowchart TD
A["Mail::to()->send(new OrderShipped())"] --> B{"ShouldQueue
implémentée ?"}
B -- "Non" --> C["Envoi synchrone
via Mailer"]
B -- "Oui" --> D["Mise en file
envoi en arrière-plan"]
D --> C
C --> E{"Driver MAIL"}
E --> F["smtp"]
E --> G["ses / mailgun
/ postmark"]
E --> H["log
(développement)"]
```
```php theme={null}
order_id);
Mail::to($request->user())->send(new OrderShipped($order));
return redirect('/orders');
}
}
```
Vous pouvez ajouter des destinataires en CC / BCC.
```php theme={null}
Mail::to($request->user())
->cc($ccUsers)
->bcc($bccUsers)
->send(new OrderShipped($order));
```
Pour utiliser un mailer précis :
```php theme={null}
Mail::mailer('postmark')
->to($request->user())
->send(new OrderShipped($order));
```
## Envoi via queue
L'envoi d'e-mails influe sur le temps de réponse. Passez par la queue pour l'envoi en arrière-plan.
```php theme={null}
Mail::to($request->user())->queue(new OrderShipped($order));
```
Pour utiliser la queue, configurez-la et démarrez les workers au préalable.
Envoi différé :
```php theme={null}
Mail::to($request->user())
->later(now()->plus(minutes: 10), new OrderShipped($order));
```
Si la classe implémente `ShouldQueue`, `send()` la place systématiquement en queue.
```php theme={null}
use Illuminate\Contracts\Queue\ShouldQueue;
class OrderShipped extends Mailable implements ShouldQueue
{
// ...
}
```
### Définir connexion et nom de file via attributs PHP
Les attributs PHP permettent de spécifier la connexion et le nom de file directement sur la classe, sans chaîner `on()->queue()`.
```php theme={null}
use Illuminate\Queue\Attributes\Connection;
use Illuminate\Queue\Attributes\Queue;
#[Connection('sqs')]
#[Queue('emails')]
class OrderShipped extends Mailable implements ShouldQueue
{
// ...
}
```
Cela indique explicitement que ce Mailable ira toujours dans la file `emails` sur la connexion SQS.
## Créer un e-mail Markdown
Les e-mails Markdown exploitent le beau template HTML responsive fourni par Laravel.
### Générer un Mailable Markdown
Utilisez l'option `--markdown`.
```shell theme={null}
php artisan make:mail OrderShipped --markdown=mail.orders.shipped
```
Utilisez `markdown` dans `content()`.
```php theme={null}
use Illuminate\Mail\Mailables\Content;
public function content(): Content
{
return new Content(
markdown: 'mail.orders.shipped',
with: [
'url' => route('orders.show', $this->order),
],
);
}
```
### Écrire le template Markdown
Utilisez les composants Blade fournis par Laravel.
```blade theme={null}
# Votre commande a été expédiée
Nous vous informons que votre commande a été expédiée.
Voir la commande
Merci de votre confiance,
{{ config('app.name') }}
```
Composants disponibles :
| Composant | Description |
| ------------------ | ------------------------------------------------------ |
| `` | Bouton (`color` accepte `primary`, `success`, `error`) |
| `` | Panneau mis en évidence |
| `` | Table Markdown |
Une version texte brut est aussi générée automatiquement pour les clients qui ne prennent pas en charge le HTML.
## Prévisualiser les e-mails
Retournez une instance de Mailable depuis une route pour prévisualiser dans le navigateur, très utile en développement.
```php theme={null}
// routes/web.php
Route::get('/mailable', function () {
$order = App\Models\Order::first();
return new App\Mail\OrderShipped($order);
});
```
## E-mails en développement local
Pour éviter d'envoyer des e-mails réels par erreur, utilisez un outil comme [Mailpit](https://github.com/axllent/mailpit).
```ini theme={null}
# .env (Mailpit)
MAIL_MAILER=smtp
MAIL_HOST=127.0.0.1
MAIL_PORT=1025
```
`Laragon` et `Laravel Herd` incluent Mailpit par défaut.
Le driver `log` écrit le contenu du mail dans les logs. C'est le moyen le plus simple pour vérifier un envoi.
```ini theme={null}
MAIL_MAILER=log
```
## Récapitulatif
| Objectif | Méthode |
| ----------------------------- | --------------------------------- |
| Créer un Mailable | `php artisan make:mail ClassName` |
| Définir l'expéditeur | `from` dans `envelope()` |
| Utiliser un template Blade | `view` dans `content()` |
| Utiliser un template Markdown | `markdown` dans `content()` |
| Envoyer | `Mail::to()->send()` |
| Envoyer via queue | `Mail::to()->queue()` |
| Envoi différé | `Mail::to()->later()` |
## Related topics
- [Réinitialisation du mot de passe](/fr/passwords.md)
- [Queues et jobs](/fr/queues.md)
- [Vérification de l'e-mail (Email Verification)](/fr/verification.md)
- [Notifications](/fr/notifications.md)
- [Événements et listeners](/fr/events.md)