Enregistrement du courrier dans Laravel 5.3: Extension du conducteur de messagerie

Laravel 5.3 Extension Envoi du courrier: Journal de courrier de la base de données personnalisée

Laravel 5.3 fournit un moyen facile de configurer et d'envoyer des e-mails via une variété de services populaires et comprend un programme d'assistance Log pour le développement. Cependant, il ne couvre pas tous les services disponibles et peut nécessiter une extension des systèmes de pilotes de messagerie existants.

Points clés:

• Laravel 5.3 fournit un moyen facile de configurer et d'envoyer facilement les e-mails via une variété de services populaires et comprend des programmes d'assistance aux journaux pour le développement. Cependant, il ne couvre pas tous les services disponibles et peut nécessiter une extension d'un système de pilote de messagerie existant.
• Pour étendre le système de pilotes de messagerie, vous pouvez utiliser l'assistant de ligne de commande Artisan pour créer un nouveau fournisseur de services. Ce fournisseur de services interagit avec l'application et enregistre le service au démarrage.
• Le nouveau fournisseur de services peut étendre le IlluminateMailMailServiceProvider existant, permettant l'implémenter la méthode register. Cela permet la création d'un nouveau gestionnaire de transport qui lie une instance rapide de Mailer à un conteneur.
• Le système de pilote de messagerie étendu peut être utilisé pour enregistrer les e-mails dans les tables de base de données pour le débogage. Cela se fait en créant une nouvelle migration et un nouveau modèle pour la table de base de données pour interagir avec la table. Ensuite, ajoutez le fournisseur à la liste des fournisseurs dans le fichier config/app.php et enregistrez le pilote de messagerie à config/mail.php dans le fichier db.

Laravel offre de nombreuses fonctionnalités pratiques, y compris la livraison de courrier. Vous pouvez facilement configurer et envoyer des e-mails via une variété de services populaires, et il inclut même les programmes d'assistance Log pour le développement.

Mail::send('emails.welcome', ['user' => $user], function ($m) use ($user) {
    $m->to($user->email, $user->name)->subject('Welcome to the website');
});

Cela utilisera la vue emails.welcome pour envoyer des e-mails aux utilisateurs nouvellement enregistrés sur le site Web. En utilisant par la poste dans Laravel 5.3, cela devient plus facile (mais l'ancienne syntaxe est toujours valide).

Ce qui suit est un exemple:

# 生成一个新的可邮件类
php artisan make:mail WelcomeMail

// app/Mail/WelcomeMail.php

class WelcomeUser extends Mailable
{
    use Queueable, SerializesModels;

    public $user;

    public function __construct(User $user)
    {
        $this->user = $user;
    }

    public function build()
    {
        return $this->view('emails.welcome');
    }
}

// routes/web.php

Route::get('/', function () {
    $user = User::find(2);

    \Mail::to($user->email)->send(new WelcomeUser($user));

    return "done";
});

Laravel fournit également un bon point de départ pour l'envoi de courrier à l'aide des pilotes de journal pendant la phase de développement, et SMTP, SparkPost, Mailgun, etc. pendant la phase de production. Cela semble bon dans la plupart des cas, mais cela ne couvre pas tous les services disponibles! Dans ce tutoriel, nous apprendrons à étendre un système de pilote de messagerie existant pour ajouter nos propres pilotes.

Pour rendre notre exemple simple et clair, nous enregistrons le courrier connecté à la table de la base de données.

Créer un fournisseur de services

La méthode préférée pour y parvenir est de créer un fournisseur de services qui peut interagir avec notre application et enregistrer nos services au démarrage. Générons d'abord un nouveau fournisseur de services à l'aide de l'assistant de ligne de commande Artisan.

Mail::send('emails.welcome', ['user' => $user], function ($m) use ($user) {
    $m->to($user->email, $user->name)->subject('Welcome to the website');
});

Cela créera une nouvelle classe dans notre dossier app/Providers. Si vous connaissez le fournisseur de services Laravel, vous saurez que nous avons étendu la classe ServiceProvider et défini les méthodes boot et register. Vous pouvez en savoir plus sur le fournisseur dans la documentation.

Utilisation du fournisseur de messagerie

Au lieu d'utiliser la classe du fournisseur de services parent, nous pouvons prendre des raccourcis et étendre le IlluminateMailMailServiceProvider existant. Cela signifie que la méthode register a été implémentée.

# 生成一个新的可邮件类
php artisan make:mail WelcomeMail

La méthode

registerSwiftMailer renvoie le pilote de transfert correspondant en fonction de la valeur de configuration mail.driver. Ce que nous pouvons faire ici, c'est effectuer un chèque avant d'appeler la méthode registerSwiftMailer Parent et de retourner notre propre transfert Manager .

// app/Mail/WelcomeMail.php

class WelcomeUser extends Mailable
{
    use Queueable, SerializesModels;

    public $user;

    public function __construct(User $user)
    {
        $this->user = $user;
    }

    public function build()
    {
        return $this->view('emails.welcome');
    }
}

en utilisant le gestionnaire de transfert

Laravel analyse l'instance swift.mailer du CIO, qui devrait renvoyer l'instance SwiftMailer de Swift_Mailer. Nous devons lier notre instance Swift Mailer au conteneur.

// routes/web.php

Route::get('/', function () {
    $user = User::find(2);

    \Mail::to($user->email)->send(new WelcomeUser($user));

    return "done";
});

Vous pouvez traiter l'objet de transfert comme le pilote réel. Si vous vérifiez l'espace de noms IlluminateMailTransport, vous trouverez différentes classes de transport pour chaque pilote (par exemple: LogTransport, SparkPostTransport, etc.).

La classe

Swift_Mailer nécessite une instance Swift_Transport, que nous pouvons satisfaire en étendant la classe IlluminateMailTransportTransport. Cela devrait ressembler à ceci.

php artisan make:provider DBMailProvider

La seule façon de mettre en œuvre ici est la méthode send. Il est responsable de la logique d'envoi du courrier, auquel cas il devrait enregistrer nos e-mails à la base de données. Quant à notre constructeur, nous pouvons le laisser vide pour l'instant, car nous n'avons pas besoin de dépendances externes.

La méthode

$message->getTo() renvoie toujours un tableau associatif d'e-mail et de nom du destinataire. Nous utilisons la fonction array_keys pour obtenir la liste de diffusion, puis les fusionne pour obtenir la chaîne.

Enregistrer le courrier électronique à la base de données

L'étape suivante consiste à créer les migrations nécessaires pour nos tables de base de données.

// vendor/Illuminate/Mail/MailServiceProvider.php

public function register()
{
    $this->registerSwiftMailer();

    // ...
}

// app/Providers/DBMailProvider.php

function registerSwiftMailer()
{
    if ($this->app['config']['mail.driver'] == 'db') {
        $this->registerDBSwiftMailer();
    } else {
        parent::registerSwiftMailer();
    }
}

Notre migration ne contient que des e-mails, un e-mail et un e-mail du destinataire, mais vous pouvez ajouter plus de détails au besoin. Vérifiez la définition de classe Swift_Mime_Message pour voir une liste des champs disponibles.

Maintenant, nous devons créer un nouveau modèle pour interagir avec notre table et ajouter les champs nécessaires au tableau fillable.

Mail::send('emails.welcome', ['user' => $user], function ($m) use ($user) {
    $m->to($user->email, $user->name)->subject('Welcome to the website');
});

# 生成一个新的可邮件类
php artisan make:mail WelcomeMail

Envoyez un e-mail

D'accord, il est temps de tester ce que nous avons réalisé jusqu'à présent. Nous ajoutons d'abord notre fournisseur à la liste des fournisseurs dans le fichier config/app.php.

// app/Mail/WelcomeMail.php

class WelcomeUser extends Mailable
{
    use Queueable, SerializesModels;

    public $user;

    public function __construct(User $user)
    {
        $this->user = $user;
    }

    public function build()
    {
        return $this->view('emails.welcome');
    }
}

Ensuite, nous enregistrons le pilote de messagerie dans config/mail.php dans le fichier db.

// routes/web.php

Route::get('/', function () {
    $user = User::find(2);

    \Mail::to($user->email)->send(new WelcomeUser($user));

    return "done";
});

La seule pièce restante est d'envoyer un e-mail de test et de vérifier s'il est connecté à la base de données. J'enverrai un e-mail lorsque j'accéderai à l'URL de la page d'accueil. Ce qui suit est le code.

php artisan make:provider DBMailProvider

Après avoir accédé à l'itinéraire de page d'accueil, nous pouvons exécuter la commande php artisan tinker pour vérifier l'enregistrement de la table emails.

Conclusion

Dans cet article, nous voyons comment étendre le système du pilote de messagerie pour intercepter les e-mails pour le débogage. Une chose que j'apprécie à Laravel est son évolutivité inégalée: vous pouvez changer ou tout étendre, des routeurs et des CIO au courrier et à peu près tout le reste.

Si vous avez des questions ou des commentaires, assurez-vous de les publier ci-dessous et je ferai de mon mieux pour répondre!

FAQ sur la journalisation du courrier dans Laravel 5.3 (FAQ)

Comment étendre le conducteur de messagerie dans Laravel 5.3?

étendre le pilote de messagerie dans Laravel 5.3 implique la création d'un nouveau fournisseur de services. Ce fournisseur de services étendra le pilote de messagerie existant et vous permettra d'ajouter des fonctionnalités supplémentaires. Vous pouvez utiliser la commande php artisan make:provider pour créer un nouveau fournisseur de services. Après avoir créé le fournisseur, vous pouvez l'enregistrer dans le fichier config/app.php. Dans le fournisseur, vous pouvez utiliser la méthode extend pour ajouter des fonctionnalités personnalisées au pilote de messagerie.

Quel est le but de la journalisation du courrier à Laravel?

La journalisation du courrier à Laravel est une fonctionnalité qui vous permet de suivre tous les e-mails sortants envoyés par votre application. Ceci est très utile pour le débogage car il vous permet de voir exactement quels e-mails sont envoyés, quand et à qui. Il est également très utile pour l'audit car il fournit un enregistrement de toutes les communications par e-mail envoyées par la demande.

Comment configurer Laravel pour enregistrer tous les e-mails sortants?

Pour configurer Laravel pour enregistrer tous les e-mails sortants, vous devez modifier le fichier config/mail.php. Dans ce fichier, vous pouvez définir l'option log sur true. Cela demande à Laravel de enregistrer tous les e-mails sortants. Les journaux seront stockés dans le répertoire storage/logs.

Comment afficher les journaux de messagerie dans Laravel?

Les journaux de courrier dans Laravel sont stockés dans le répertoire storage/logs. Vous pouvez afficher ces journaux en naviguant vers ce répertoire et en ouvrant le fichier journal. Les fichiers journaux sont nommés selon les dates, vous pouvez donc facilement trouver des journaux pour des dates spécifiques.

Puis-je personnaliser le format des journaux de messagerie dans Laravel?

Oui, vous pouvez personnaliser le format des journaux de courrier dans Laravel. Cela peut être fait en étendant le pilote de messagerie et en remplacement de la méthode log. Dans cette méthode, vous pouvez spécifier le format du message de journal.

(le reste de la FAQ est lié à l'e-mail qui s'envoie et n'a rien à voir avec l'extension du journal de messagerie dans cet exemple, il est donc omis)

Veuillez noter que les chemins d'image /uploads/20250210/173915090467a9563807841.webp et /uploads/20250210/173915090467a9563839bfc.webp et /uploads/20250210/173915090667a9563a27b41.jpg doivent être remplacés par des liens d'image accessibles réels.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!