Pièces jointes en ligne

L'intégration d'images en ligne dans les e-mails est souvent fastidieuse ; cependant, Laravel fournit un moyen simple de joindre une image à un e-mail et d'obtenir le CID approprié. Les images en ligne peuvent être intégrées à l'aide de la méthode embed de la variable $message dans le modèle d'e-mail. Laravel rend automatiquement la variable $message disponible dans tous les modèles d'e-mails, pas besoin de vous soucier de la transmettre manuellement : 🎜

use Illuminate\Contracts\Translation\HasLocalePreference;
class User extends Model implements HasLocalePreference{    
     /**
     * 获取用户首选区域设置。
     *
     * @return string
     */   
  public function preferredLocale() 
     {     
        return $this->locale;  
       }
    }

{note} $message dans texte Non disponible dans Messages car les messages texte ne peuvent pas utiliser de pièces jointes en ligne. 🎜🎜🎜🎜

Intégrer la pièce jointe des données d'origine

Si vous disposez déjà de la chaîne de données d'origine que vous souhaitez intégrer dans le modèle d'e-mail, vous pouvez utiliser la méthode embedData de la variable $message : $message 变量的 embedData 方法：

Mail::to($request->user())->send(new OrderShipped($order));

自定义 SwiftMailer 消息

Mailable 基类的 withSwiftMessage 方法允许你注册一个回调，它将在发送消息之前被调用，原始的 SwiftMailer 消息将作为该回调的参数：

'to' => [ 
   'address' => 'example@example.com',    
   'name' => 'Example'
  ],

Markdown 格式的 Mailables 类

Markdown 格式 mailable 消息允许你从预构建模板和 mailable 类中的邮件通知组件获益。由于消息使用 Markdown 书写，Laravel 能够渲染出美观的、响应式的 HTML 模板消息，还能自动生成文本副本。

生成 Markdown 格式的 Mailables 类

要生成一个适用 Markdown 模板的 mailable，可以使用带有 --markdown 选项的 make:mail Artisan 命令：

/**
 * 为应用映射事件侦听器。
 *
 * @var array
 */
 protected $listen = [  
   'Illuminate\Mail\Events\MessageSending' => [     
      'App\Listeners\LogSendingMessage',   
   ],    
   'Illuminate\Mail\Events\MessageSent' => [     
      'App\Listeners\LogSentMessage', 
        ],
   ];

然后，在它的 build 方法中配置 mailable，调用 markdown 方法代替 view 方法。 markdown 方法接受 Markdown 模板名和一个可选的在模板中可用的数组：

rrreee

编写 Markdown 消息

Markdown mailable 使用 Blade 组件和 Markdown 语法组合，让你可以更方便地利用 Laravel 预制组件构建邮件消息：

rrreee

{tip} 编写 Markdown 邮件时不要使用额外的缩进。Markdown 解析器将把缩进内容渲染成代码块。

按钮组件

按钮组件渲染一个居中按钮链接。此组建接受两个参数， url 和可选的 color。颜色选项支持 primary、 success 和 errorrrreee

Personnalisation du message SwiftMailer

Classe de base Mailable La méthode withSwiftMessage vous permet d'enregistrer un rappel qui sera appelé avant d'envoyer le message, avec le message SwiftMailer d'origine comme argument de ce rappel :

rrreee

Classe Mailables au format Markdown

Les messages mailables au format Markdown vous permettent de bénéficier de pré- modèles créés et composants de notification par courrier électronique dans la classe mailable. Étant donné que les messages sont écrits en Markdown, Laravel peut restituer de superbes messages modèles HTML réactifs et générer automatiquement des copies de texte.

Générer une classe Mailables au format Markdown

Pour générer un Modèle Markdown mailable, vous pouvez utiliser la commande make:mail Artisan avec l'option --markdown :

rrreee

Ensuite, dans son build Configurer mailable dans la méthode et appelez la méthode markdown au lieu de la méthode view. La méthode markdown accepte le nom du modèle Markdown et un tableau facultatif de noms disponibles dans le modèle : 🎜rrreee🎜🎜🎜

🎜

Rédaction de messages Markdown

🎜Markdown mailable utilise une combinaison de composants Blade et de syntaxe Markdown, vous permettant d'utiliser plus facilement les composants préfabriqués Laravel pour créer des messages électroniques : 🎜rrreee

🎜{astuce } N'utilisez pas d'indentation supplémentaire lors de la rédaction d'e-mails Markdown. L'analyseur Markdown restituera le contenu indenté en blocs de code. 🎜

🎜🎜Composant Bouton🎜🎜Le composant Bouton restitue un lien de bouton centré. Ce composant accepte deux paramètres, url et éventuellement color. Les options de couleur prennent en charge primaire, succès et erreur. Vous pouvez ajouter autant de composants de bouton à votre message que vous le souhaitez : 🎜rrreee🎜🎜🎜Composant du panneau🎜🎜Le composant du panneau restitue un bloc de texte donné à l'intérieur d'un panneau avec une couleur d'arrière-plan légèrement différente de celle du reste du message. Permet de dessiner un bloc de texte d'avertissement : 🎜rrreee🎜🎜🎜Composant Table🎜🎜Le composant Table vous permet de convertir des tableaux Markdown en tableaux HTML. Ce composant accepte une table Markdown comme contenu. L'alignement des colonnes prend en charge la syntaxe d'alignement des tableaux Markdown par défaut : 🎜rrreee🎜🎜🎜🎜🎜🎜

Composants personnalisés

Vous pouvez exporter tous les composants de courrier électronique Markdown vers votre propre application et les utiliser comme modèles pour les composants personnalisés. Pour exporter ces composants, utilisez la commande vendor:publish Artisan avec la balise d'actifs laravel-mail : laravel-mail 资产标签的 vendor:publish Artisan 命令：

rrreee

此命令将 Markdown 邮件组件导出到 resources/views/vendor/mail 目录。 mail 目录包含 html 和 text 子目录， 分别包含各自对应的可用组件描述。可以按照自己的意愿自定义这些组件。

自定义 CSS

组建导出以后，resources/views/vendor/mail/html/themes 目录有一个 default.css 文件。可以自此文件中自定义 CSS，这些样式将自动内联到 Markdown 邮件消息的 HTML 表示中。

{tip} 如果想为 Markdown 组件创建完整的新主题，可以在 html/themes 目录新建一个 CSS 文件，并修改 mail 配置文件的  theme 选项。

发送邮件

若要发送邮件，使用 Mail facade 的 to 方法。 to 方法接受 邮件地址、用户实例或用户集合。如果传递一个对象或者对象集合，mailer 在设置收件人时将自动使用它们的 email 和 name 属性，因此请确保对象的这些属性可用。一旦制定了收件人，就可以将 mailable 类实例传递给 send 方法：

rrreee

在发送消息时不止可以指定收件人。还可以通过链式调用「to」、「cc」、「bcc」一次性指定抄送和密送收件人：

rrreee

渲染 Mailable

有时可能希望捕获 mailable 的 HTML 内容，而不发送它。可以调用 mailable 的 renderrrreee

Cette commande exporte le composant de messagerie Markdown vers ressources / répertoire lists/vendor/mail. Le répertoire mail contient les sous-répertoires html et text, qui contiennent les descriptions respectives des composants disponibles. Ces composants peuvent être personnalisés comme vous le souhaitez.

CSS personnalisé

Après l'export, resources/views/vendor/mail/html/themes Le répertoire a un fichier default.css. CSS peut être personnalisé à partir de ce fichier et ces styles seront automatiquement intégrés dans la représentation HTML du message électronique Markdown.

{tip} Si vous souhaitez créer un nouveau thème complet pour le composant Markdown, vous pouvez créer un nouveau fichier CSS dans le répertoire html/themes et modifier le mail< /code> option thème du fichier de configuration.

Envoi de mail

Pour envoyer un mail, utilisez La méthode to de la façade Mail. La méthode to accepte une adresse e-mail, une instance d'utilisateur ou une collection d'utilisateurs. Si vous transmettez un objet ou une collection d'objets, le logiciel de messagerie utilisera automatiquement ses propriétés email et name lors de la définition des destinataires, alors assurez-vous que ces propriétés sont disponibles sur l'objet. Une fois les destinataires spécifiés, une instance de classe pouvant être envoyée par courrier peut être transmise à la méthode send : rrreeeVous pouvez spécifier plus que de simples destinataires lors de l'envoi d'un message. Vous pouvez également spécifier simultanément les destinataires CC et BCC en appelant "à", "cc" et "bcc" dans une chaîne :

rrreee

Rendu Mailable

Parfois, vous souhaiterez peut-être capturer le contenu HTML d'un mailable sans l'envoyer. Cela peut être accompli en appelant la méthode render du mailable. Cette méthode renvoie la chaîne calculée une fois le mailable rendu :

rrreee🎜🎜🎜🎜🎜🎜🎜Prévisualisation du mailable dans le navigateur🎜🎜Lors de la conception d'un modèle mailable, il est pratique de prévisualiser et de restituer le mailable dans le navigateur, tout comme le Modèle de lame. Dans ce cas, Laravel vous permet de renvoyer n'importe quel mailable directement lors d'une fermeture ou d'un contrôle d'itinéraire. Le mailable renvoyé sera rendu et affiché dans le navigateur, et vous pourrez rapidement prévisualiser le design sans avoir à l'envoyer à une véritable adresse e-mail : 🎜rrreee🎜🎜🎜🎜🎜🎜🎜Mail Queue🎜🎜🎜

Ajouter des e-mails à la file d'attente

Étant donné que l'envoi d'e-mails peut prolonger considérablement le temps de réponse de l'application, de nombreux développeurs choisissent de mettre les e-mails en file d'attente et de les envoyer en arrière-plan. Laravel facilite cela grâce à son API de file d'attente unifiée intégrée. Pour ajouter un email à la file d'attente, vous pouvez utiliser la méthode queue de la façade Mail après avoir précisé le destinataire du message : Mail facade 的 queue 方法：

rrreee

此方法自动将作业推送到队列中以便消息在后台发送。使用此特性之前，需要 配置队列 ：

延迟消息队列

想要延迟发送队列化的邮件消息，可以使用 later 方法。later 方法的第一个参数的第一个参数是标示消息何时发送的 DateTime 实例：

rrreee

推送到指定队列

由于所有使用 make:mail 命令生成的 mailable 类都是用了 IlluminateBusQueueable trait，因此你可以在任何 mailable 类实例上调用 onQueue 和 onConnection 方法来指定消息的连接和队列名：

rrreee

默认队列

如果一个 mailable 类终是要队列化，可以在此类上实现 ShouldQueue 契约。这样一来，即使你在发送时调用了 send 方法， mailable 也将被序列化：

rrreee

本地化 Mailable

Laravel 允许你使用有别于当前语言的区域设置发送 mailable，即使被加入到队列中也保留该区域设置。

为达到此目的， Mail facade 提供了 locale 方法设置目标语言。应用在格式化 mailable 是将切换到该区域设置，并在格式化完成后恢复到原来的区域设置：

rrreee

用户首选区域设置

有时候，应用存储每个用户的首选区域设置。通过在一个或多个模型上实现 HasLocalePreference 契约，可以通知 Laravel 再发送邮件时使用预存的区域设置：

rrreee

一旦实现了此接口，Laravel 在向此模型发送 mailable 和通知时，将自动使用首选区域设置。因此在使用此接口时不需要调用 localerrreee

Cette méthode pousse automatiquement le job à la file d'attente afin que le message soit envoyé en arrière-plan. Avant d'utiliser cette fonctionnalité, vous devez configurer la file d'attente :

Délai de la file d'attente des messages

Si vous souhaitez retarder l'envoi des e-mails en file d'attente, vous pouvez utiliser plus tard. Le premier paramètre de la méthode later est DateTime qui indique quand le message a été envoyé. Exemple :

rrreee

.

Push vers la file d'attente spécifiée

Étant donné que toutes les classes mailables générées à l'aide de la commande make:mail utilisent le trait IlluminateBusQueueable, vous pouvez l'utiliser dans n'importe quelle classe mailable. Appelez le < méthodes code>onQueue et onConnection sur l'instance pour spécifier la connexion du message et le nom de la file d'attente :

rrreee

🎜Default Queue 🎜🎜Si une classe mailable doit finalement être mise en file d'attente, le contrat ShouldQueue peut être implémenté sur cette classe. De cette façon, le mailable sera sérialisé même si vous appelez la méthode send lors de l'envoi : 🎜rrreee🎜🎜🎜

🎜🎜Mailable localisé🎜🎜Laravel vous permet d'envoyer un mailable en utilisant une langue différente de la langue actuelle, en conservant cette langue même lorsqu'elle est ajoutée à la file d'attente. 🎜🎜Pour atteindre cet objectif, la façade Mail fournit la méthode locale pour définir la langue cible. L'application qui formate le mailable basculera vers ces paramètres régionaux et reviendra aux paramètres régionaux d'origine une fois le formatage terminé : 🎜rrreee

🎜

Paramètres régionaux préférés de l'utilisateur🎜Parfois, les applications stockent les paramètres régionaux préférés de chaque utilisateur. En implémentant le contrat HasLocalePreference sur un ou plusieurs modèles, vous pouvez demander à Laravel d'utiliser les paramètres régionaux stockés lors de l'envoi d'e-mails : 🎜rrreee🎜Une fois cette interface implémentée, Laravel envoie des mailables et des notifications à ce modèle, le les paramètres régionaux préférés sont automatiquement utilisés. Il n'est donc pas nécessaire d'appeler la méthode locale lorsque vous utilisez cette interface : 🎜rrreee🎜🎜🎜🎜🎜🎜🎜Mail & Local Development🎜🎜Lors du développement d'une application qui envoie des emails, vous ne souhaiterez peut-être pas envoyez réellement des e-mails à une adresse en temps réel pour envoyer du courrier. Laravel propose plusieurs façons de "désactiver" l'envoi réel lors du développement local. 🎜🎜🎜

Log driver

log Le pilote de messagerie écrit les e-mails dans des journaux au lieu d'envoyer des e-mails, prêts à être consultés. Pour plus d’informations sur la configuration de l’environnement d’application, veuillez consulter la documentation de configuration. log 邮件驱动采取将邮件消息写入日志取代发送邮件，已备查看。应用环境配置的更多消息，请查阅 配置文档。

通用配置

Laravel 为通过框架发送的邮件提供了指定常用收件人的其他解决方案。通过此方法，应用生成的邮件都将发送到指定地址，以取代发送消息时指定的真实地址。可以借助 config/mail.php 配置文件的 to 选项实现此目的：

rrreee

Mailtrap

最后，你可以使用 Mailtrap 服务和 smtp 驱动发送邮件消息到 「虚拟」邮箱，这样就可以在真实的邮件客户端查看邮件消息。此方法的好处是允许你在 Mailtrap 的消息阅览器中实际查看最终的邮件。

事件

Laravel 在处理邮件消息发送时触发两个事件。MessageSending 事件在消息发送前触发，MessageSent 事件则在消息发送后触发。切记，这些事件是在邮件被 发送 时触发，而不是在队列化的时候。可以在  EventServiceProvider

Configuration universelleLaravel fournit des solutions supplémentaires pour spécifier les destinataires communs pour les e-mails envoyés via des frames. Avec cette méthode, les emails générés par l'application seront envoyés à l'adresse spécifiée, en remplacement de l'adresse réelle spécifiée lors de l'envoi du message. Ceci peut être réalisé à l'aide de l'option to du fichier de configuration config/mail.php :

rrreee

🎜Mailtrap 🎜🎜Enfin, vous pouvez utiliser le service Mailtrap🎜 et le pilote smtp pour envoyer des e-mails à un "virtuel" boîte aux lettres, afin qu'ils puissent être utilisés dans de vrais e-mails. Le client visualise les e-mails. L'avantage de cette méthode est qu'elle vous permet de visualiser réellement l'e-mail final dans la visionneuse de messages de Mailtrap. 🎜🎜🎜🎜

🎜

Événements

🎜Laravel déclenche deux événements lors de la gestion de l'envoi d'e-mails. L'événement MessageSending est déclenché avant l'envoi du message, et l'événement MessageSent est déclenché après l'envoi du message. N'oubliez pas que ces événements sont déclenchés lorsque le message est envoyé, et non lorsqu'il est mis en file d'attente. Un auditeur pour cet événement peut être enregistré dans EventServiceProvider : 🎜rrreee🎜Cet article a été publié pour la première fois sur le site 🎜LearnKu.com🎜. 🎜🎜

← Fonction d'assistance

Notification des messages →

soumettre

Site Web PHP chinois

MaisonCoursArticleQuestions et réponsesDictionnaireManuelTéléchargerrecherche APPTélécharger