Laravel 编码技巧 - 邮件

测试电子邮件到 laravel.log

如果你想在应用中测试电子邮件内容，但又不想或无法设置像 Mailgun 这样的服务，可以使用 .env 参数 MAIL_DRIVER=log，所有的电子邮件将被保存到 storage/logs/laravel.log 文件中，而不是实际发送。

在 Laravel 中，您无需将文件存储起来就能将它们用作电子邮件附件。

只需在 Mailables 中使用 attachData 就能将用户上传的文件添加到电子邮件中。

以下是一个使用它的 Mailable 类的片段：

public function build()
{
     return $this->subject('Inquiry')
          ->to('example@example.com')
          ->markdown('email.inquiry')
          ->attachData(
               $this->file,
               $this->file->getClientOriginalName(),
          );
}

在Laravel中，你不必存储文件即可将其用作电子邮件附件

只需使用 attachData 就能在 Mailables 中添加用户上传的文件。

以下是一个使用它的 Mailable 类的片段：

public function build()
{
     return $this->subject('Inquiry')
          ->to('example@example.com')
          ->markdown('email.inquiry')
          ->attachData(
               $this->file,
               $this->file->getClientOriginalName(),
          );
}

预览邮件

如果你使用 Mailables 发送电子邮件，您可以在浏览器中直接预览结果而不发送邮件。只需将 Mailable 作为路由结果返回即可：

Route::get('/mailable', function () {
    $invoice = App\Invoice::find(1);
    return new App\Mail\InvoicePaid($invoice);
});

预览无邮件内容的邮件

你还可以在没有 Mailables 的情况下预览电子邮件。例如，当您创建通知时，可以指定用于邮件通知的 Markdown。

use Illuminate\Notifications\Messages\MailMessage;

Route::get('/mailable', function () {
    $invoice = App\Invoice::find(1);
    return (new MailMessage)->markdown('emails.invoice-paid', compact('invoice'));
});

你也可以使用 MailMessage 对象提供的其他方法，如视图和其他方法。

Laravel 中的默认邮件主题

如果你发送 Laravel 通知并且在 toMail() 中未指定主题，则默认主题是您的通知类名，驼峰命名法转换为带有空格的形式。

因此，如果您有：

class UserRegistrationEmail extends Notification {
    //
}

那么你将收到一个主题为 "User Registration Email" 的电子邮件。

向任何人发送邮件通知

你不仅可以使用 $user->notify() 将 Laravel 通知发送给特定用户，还可以通过 Notification::route() 将通知发送给任何您想要的人，这称为“按需”通知：

Notification::route('mail', 'taylor@example.com')
        ->route('nexmo', '5555555555')
        ->route('slack', 'https://hooks.slack.com/services/...')
        ->notify(new InvoicePaid($invoice));

设置条件对象属性

你可以在 MailMessage 通知中使用 when() 或 unless() 方法来设置条件对象属性，例如调用某个操作。

class InvoicePaid extends Notification
{
    public function toMail(User $user)
    {
        return (new MailMessage)
            ->success()
            ->line('We\'ve received your payment')
            ->when($user->isonMonthlyPaymentPlan(), function (MailMessage $message) {
                $message->action('Save 20% by paying yearly', route('account.billing'));
            })
            ->line('Thank you for using Unlock.sh');
    }
}

在上面的例子中，when() 方法用于根据用户是否使用月度付款计划动态添加操作按钮。如果用户正在使用月度付款计划，则会添加一个 "Save 20% by paying yearly" 的操作按钮。

你还可以在自己的类中使用 when() 或 unless() 方法，通过使用 Illuminate\Support\Traits\Conditionable 特性。