Envoyer des e-mails

Configuration d’un environnement local

Avant de commencer à envoyer des e-mails dans une application, il faut correctement configurer l’environnement de travail pour tester sereinement l’envoi d’e-mails en local. Un environnement de travail bien préparé permet de vérifier le contenu des e-mails sans les envoyer réellement, afin d’éviter des déconvenues comme, par exemple, un envoi massif à des utilisateurs réels par inadvertance. Les mécanismes de gestion des e-mails en local mis en place par les équipes de développement peuvent être contraignants : ils envahissent une boîte e-mail dite de test ou alors les e-mails ne partent pas du tout et il faut espérer qu’en production cela fonctionne.

Laravel permet de désactiver de différentes manières l’envoi effectif d’e-mails pendant le développement, sans avoir à ajouter une ligne de code dans l’application. Il faudra simplement changer une valeur de configuration sur l’environnement local.

Préparer des e-mails

sail artisan make:mail Invitation  

<?php 
 
namespace App\Mail; 
 
use Illuminate\Bus\Queueable; 
use Illuminate\Contracts\Queue\ShouldQueue; 
use Illuminate\Mail\Mailable; 
use Illuminate\Mail\Mailables\Content; 
use Illuminate\Mail\Mailables\Envelope; 
use Illuminate\Queue\SerializesModels; 
 
class Invitation extends Mailable 
{ 
 
    use Queueable, SerializesModels; 
 
    /** 
     * Create a new message instance. 
     */ 
    public function __construct() 
    { 
 
        // 
 
    } 
 
    /** 
     * Get the message envelope. 
     */ 
    public function envelope(): Envelope 
    { 
 
        return new Envelope( 
            subject:...

Envoyer des e-mails

<?php 
 
namespace App\Http\Controllers; 
 
use App\Mail\Invitation; 
use Illuminate\Support\Facades\Mail; 
 
class InvitationController extends Controller 
{ 
 
    public function invite() 
    { 
 
        // Envoi du mail en direct ...

Utiliser des notifications

En supplément de la prise en charge de l’envoi d’e-mails, Laravel permet également d’envoyer des notifications. Une notification est en général un message court à destination des utilisateurs, faisant suite à une action sur l’application. Par exemple, pour prévenir les administrateurs qu’un nouvel article a été posté, ou qu’un achat a eu lieu sur le site.

Une notification doit être brève, avertissant une personne qu’un événement s’est produit. L’envoi de la notification peut s’effectuer à travers différents canaux de diffusion. Un canal de diffusion peut être, par exemple, un e-mail. Cela permet donc d’envoyer rapidement un e-mail notifiant une action. Mais il est également possible d’envoyer des notifications à destination d’autres canaux de diffusion :

sail artisan make:notification CommentPosted  

Choisir un pilote pour la production

Une fois les tests terminés, il faut choisir un pilote pour envoyer réellement les e-mails en environnement de production.

Par le passé, les applications PHP utilisaient directement la fonction mail. Le serveur envoyait alors lui-même l’e-mail avec l’application sendmail. Les développeurs ou administrateurs avaient la charge de configurer correctement le message et le serveur d’e-mail eux-mêmes, ce qui avait parfois pour effet de faire arriver les e-mails dans les courriers indésirables.

Aujourd’hui, de nombreux services permettent d’envoyer des e-mails qualifiés, par SMTP ou grâce à une API simple, avec un suivi précis de chaque e-mail. C’est pourquoi, pour une application professionnelle, il est préférable de s’appuyer sur un de ces nombreux services. La plupart ont des coûts relativement bas, gratuits pour quelques milliers d’e-mails par mois, ce qui est généralement suffisant pour la phase de lancement d’une application. Par la suite, le coût restera faible et devrait être amorti avec le temps gagné pour l’innovation.

Laravel s’appuie sur la bibliothèque Symfony Mailer (https://github.com/symfony/mailer) pour envoyer les e-mails. Cela permet d’émettre des e-mails de qualité (avec les bons en-têtes formatés...