郵件

1composer require symfony/mailgun-mailer symfony/http-client

1'default' => env('MAIL_MAILER', 'mailgun'),

1'mailgun' => [
2    'transport' => 'mailgun',
3    // 'client' => [
4    //     'timeout' => 5,
5    // ],
6],

1'mailgun' => [
2    'domain' => env('MAILGUN_DOMAIN'),
3    'secret' => env('MAILGUN_SECRET'),
4    'endpoint' => env('MAILGUN_ENDPOINT', 'api.mailgun.net'),
5    'scheme' => 'https',
6],

1'mailgun' => [
2    'domain' => env('MAILGUN_DOMAIN'),
3    'secret' => env('MAILGUN_SECRET'),
4    'endpoint' => env('MAILGUN_ENDPOINT', 'api.eu.mailgun.net'),
5    'scheme' => 'https',
6],

1composer require symfony/postmark-mailer symfony/http-client

1'postmark' => [
2    'token' => env('POSTMARK_TOKEN'),
3],

1'postmark' => [
2    'transport' => 'postmark',
3    'message_stream_id' => env('POSTMARK_MESSAGE_STREAM_ID'),
4    // 'client' => [
5    //     'timeout' => 5,
6    // ],
7],

1composer require resend/resend-php

1'resend' => [
2    'key' => env('RESEND_KEY'),
3],

1composer require aws/aws-sdk-php

1'ses' => [
2    'key' => env('AWS_ACCESS_KEY_ID'),
3    'secret' => env('AWS_SECRET_ACCESS_KEY'),
4    'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),
5],

1'ses' => [
2    'key' => env('AWS_ACCESS_KEY_ID'),
3    'secret' => env('AWS_SECRET_ACCESS_KEY'),
4    'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),
5    'token' => env('AWS_SESSION_TOKEN'),
6],

 1/**
 2 * Get the message headers.
 3 */
 4public function headers(): Headers
 5{
 6    return new Headers(
 7        text: [
 8            'X-Ses-List-Management-Options' => 'contactListName=MyContactList;topicName=MyTopic',
 9        ],
10    );
11}

 1'ses' => [
 2    'key' => env('AWS_ACCESS_KEY_ID'),
 3    'secret' => env('AWS_SECRET_ACCESS_KEY'),
 4    'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),
 5    'options' => [
 6        'ConfigurationSetName' => 'MyConfigurationSet',
 7        'EmailTags' => [
 8            ['Name' => 'foo', 'Value' => 'bar'],
 9        ],
10    ],
11],

1composer require mailersend/laravel-driver

1MAIL_MAILER=mailersend
2MAIL_FROM_ADDRESS[email protected]
3MAIL_FROM_NAME="App Name"
4 
5MAILERSEND_API_KEY=your-api-key

1'mailersend' => [
2    'transport' => 'mailersend',
3],

 1'mailers' => [
 2    'failover' => [
 3        'transport' => 'failover',
 4        'mailers' => [
 5            'postmark',
 6            'mailgun',
 7            'sendmail',
 8        ],
 9    ],
10 
11    // ...
12],

1'default' => env('MAIL_MAILER', 'failover'),

 1'mailers' => [
 2    'roundrobin' => [
 3        'transport' => 'roundrobin',
 4        'mailers' => [
 5            'ses',
 6            'postmark',
 7        ],
 8    ],
 9 
10    // ...
11],

1'default' => env('MAIL_MAILER', 'roundrobin'),

1php artisan make:mail OrderShipped

 1use Illuminate\Mail\Mailables\Address;
 2use Illuminate\Mail\Mailables\Envelope;
 3 
 4/**
 5 * Get the message envelope.
 6 */
 7public function envelope(): Envelope
 8{
 9    return new Envelope(
10        from: new Address('[email protected]', 'Jeffrey Way'),
11        subject: 'Order Shipped',
12    );
13}

1return new Envelope(
2    from: new Address('[email protected]', 'Jeffrey Way'),
3    replyTo: [
4        new Address('[email protected]', 'Taylor Otwell'),
5    ],
6    subject: 'Order Shipped',
7);

1'from' => [
2    'address' => env('MAIL_FROM_ADDRESS', '[email protected]'),
3    'name' => env('MAIL_FROM_NAME', 'Example'),
4],

1'reply_to' => ['address' => '[email protected]', 'name' => 'App Name'],

1/**
2 * Get the message content definition.
3 */
4public function content(): Content
5{
6    return new Content(
7        view: 'mail.orders.shipped',
8    );
9}

 1/**
 2 * Get the message content definition.
 3 */
 4public function content(): Content
 5{
 6    return new Content(
 7        view: 'mail.orders.shipped',
 8        text: 'mail.orders.shipped-text'
 9    );
10}

1return new Content(
2    html: 'mail.orders.shipped',
3    text: 'mail.orders.shipped-text'
4);

 1<?php
 2 
 3namespace App\Mail;
 4 
 5use App\Models\Order;
 6use Illuminate\Bus\Queueable;
 7use Illuminate\Mail\Mailable;
 8use Illuminate\Mail\Mailables\Content;
 9use Illuminate\Queue\SerializesModels;
10 
11class OrderShipped extends Mailable
12{
13    use Queueable, SerializesModels;
14 
15    /**
16     * Create a new message instance.
17     */
18    public function __construct(
19        public Order $order,
20    ) {}
21 
22    /**
23     * Get the message content definition.
24     */
25    public function content(): Content
26    {
27        return new Content(
28            view: 'mail.orders.shipped',
29        );
30    }
31}

1<div>
2    Price: {{ $order->price }}
3</div>

 1<?php
 2 
 3namespace App\Mail;
 4 
 5use App\Models\Order;
 6use Illuminate\Bus\Queueable;
 7use Illuminate\Mail\Mailable;
 8use Illuminate\Mail\Mailables\Content;
 9use Illuminate\Queue\SerializesModels;
10 
11class OrderShipped extends Mailable
12{
13    use Queueable, SerializesModels;
14 
15    /**
16     * Create a new message instance.
17     */
18    public function __construct(
19        protected Order $order,
20    ) {}
21 
22    /**
23     * Get the message content definition.
24     */
25    public function content(): Content
26    {
27        return new Content(
28            view: 'mail.orders.shipped',
29            with: [
30                'orderName' => $this->order->name,
31                'orderPrice' => $this->order->price,
32            ],
33        );
34    }
35}

1<div>
2    Price: {{ $orderPrice }}
3</div>

 1use Illuminate\Mail\Mailables\Attachment;
 2 
 3/**
 4 * Get the attachments for the message.
 5 *
 6 * @return array<int, \Illuminate\Mail\Mailables\Attachment>
 7 */
 8public function attachments(): array
 9{
10    return [
11        Attachment::fromPath('/path/to/file'),
12    ];
13}

 1/**
 2 * Get the attachments for the message.
 3 *
 4 * @return array<int, \Illuminate\Mail\Mailables\Attachment>
 5 */
 6public function attachments(): array
 7{
 8    return [
 9        Attachment::fromPath('/path/to/file')
10            ->as('name.pdf')
11            ->withMime('application/pdf'),
12    ];
13}

 1/**
 2 * Get the attachments for the message.
 3 *
 4 * @return array<int, \Illuminate\Mail\Mailables\Attachment>
 5 */
 6public function attachments(): array
 7{
 8    return [
 9        Attachment::fromStorage('/path/to/file'),
10    ];
11}

 1/**
 2 * Get the attachments for the message.
 3 *
 4 * @return array<int, \Illuminate\Mail\Mailables\Attachment>
 5 */
 6public function attachments(): array
 7{
 8    return [
 9        Attachment::fromStorage('/path/to/file')
10            ->as('name.pdf')
11            ->withMime('application/pdf'),
12    ];
13}

 1/**
 2 * Get the attachments for the message.
 3 *
 4 * @return array<int, \Illuminate\Mail\Mailables\Attachment>
 5 */
 6public function attachments(): array
 7{
 8    return [
 9        Attachment::fromStorageDisk('s3', '/path/to/file')
10            ->as('name.pdf')
11            ->withMime('application/pdf'),
12    ];
13}

 1/**
 2 * Get the attachments for the message.
 3 *
 4 * @return array<int, \Illuminate\Mail\Mailables\Attachment>
 5 */
 6public function attachments(): array
 7{
 8    return [
 9        Attachment::fromData(fn () => $this->pdf, 'Report.pdf')
10            ->withMime('application/pdf'),
11    ];
12}

1<body>
2    Here is an image:
3 
4    <img src="{{ $message->embed($pathToImage) }}">
5</body>

1<body>
2    Here is an image from raw data:
3 
4    <img src="{{ $message->embedData($data, 'example-image.jpg') }}">
5</body>

 1<?php
 2 
 3namespace App\Models;
 4 
 5use Illuminate\Contracts\Mail\Attachable;
 6use Illuminate\Database\Eloquent\Model;
 7use Illuminate\Mail\Attachment;
 8 
 9class Photo extends Model implements Attachable
10{
11    /**
12     * Get the attachable representation of the model.
13     */
14    public function toMailAttachment(): Attachment
15    {
16        return Attachment::fromPath('/path/to/file');
17    }
18}

1/**
2 * Get the attachments for the message.
3 *
4 * @return array<int, \Illuminate\Mail\Mailables\Attachment>
5 */
6public function attachments(): array
7{
8    return [$this->photo];
9}

1// Create an attachment from a file on your default disk...
2return Attachment::fromStorage($this->path);
3 
4// Create an attachment from a file on a specific disk...
5return Attachment::fromStorageDisk('backblaze', $this->path);

1return Attachment::fromData(fn () => $this->content, 'Photo Name');

1return Attachment::fromPath('/path/to/file')
2    ->as('Photo Name')
3    ->withMime('image/jpeg');

 1use Illuminate\Mail\Mailables\Headers;
 2 
 3/**
 4 * Get the message headers.
 5 */
 6public function headers(): Headers
 7{
 8    return new Headers(
 9        messageId: '[email protected]',
10        references: ['[email protected]'],
11        text: [
12            'X-Custom-Header' => 'Custom Value',
13        ],
14    );
15}

 1use Illuminate\Mail\Mailables\Envelope;
 2 
 3/**
 4 * Get the message envelope.
 5 *
 6 * @return \Illuminate\Mail\Mailables\Envelope
 7 */
 8public function envelope(): Envelope
 9{
10    return new Envelope(
11        subject: 'Order Shipped',
12        tags: ['shipment'],
13        metadata: [
14            'order_id' => $this->order->id,
15        ],
16    );
17}

 1use Illuminate\Mail\Mailables\Envelope;
 2use Symfony\Component\Mime\Email;
 3 
 4/**
 5 * Get the message envelope.
 6 */
 7public function envelope(): Envelope
 8{
 9    return new Envelope(
10        subject: 'Order Shipped',
11        using: [
12            function (Email $message) {
13                // ...
14            },
15        ]
16    );
17}

1php artisan make:mail OrderShipped --markdown=mail.orders.shipped

 1use Illuminate\Mail\Mailables\Content;
 2 
 3/**
 4 * Get the message content definition.
 5 */
 6public function content(): Content
 7{
 8    return new Content(
 9        markdown: 'mail.orders.shipped',
10        with: [
11            'url' => $this->orderUrl,
12        ],
13    );
14}

 1<x-mail::message>
 2# Order Shipped
 3 
 4Your order has been shipped!
 5 
 6<x-mail::button :url="$url">
 7View Order
 8</x-mail::button>
 9 
10Thanks,<br>
11{{ config('app.name') }}
12</x-mail::message>

1<x-mail::button :url="$url" color="success">
2View Order
3</x-mail::button>

1<x-mail::panel>
2This is the panel content.
3</x-mail::panel>

1<x-mail::table>
2| Laravel       | Table         | Example       |
3| ------------- | :-----------: | ------------: |
4| Col 2 is      | Centered      | $10           |
5| Col 3 is      | Right-Aligned | $20           |
6</x-mail::table>

1php artisan vendor:publish --tag=laravel-mail

 1<?php
 2 
 3namespace App\Http\Controllers;
 4 
 5use App\Http\Controllers\Controller;
 6use App\Mail\OrderShipped;
 7use App\Models\Order;
 8use Illuminate\Http\RedirectResponse;
 9use Illuminate\Http\Request;
10use Illuminate\Support\Facades\Mail;
11 
12class OrderShipmentController extends Controller
13{
14    /**
15     * Ship the given order.
16     */
17    public function store(Request $request): RedirectResponse
18    {
19        $order = Order::findOrFail($request->order_id);
20 
21        // Ship the order...
22 
23        Mail::to($request->user())->send(new OrderShipped($order));
24 
25        return redirect('/orders');
26    }
27}

1Mail::to($request->user())
2    ->cc($moreUsers)
3    ->bcc($evenMoreUsers)
4    ->send(new OrderShipped($order));

1foreach (['[email protected]', '[email protected]'] as $recipient) {
2    Mail::to($recipient)->send(new OrderShipped($order));
3}

1Mail::mailer('postmark')
2    ->to($request->user())
3    ->send(new OrderShipped($order));

1Mail::to($request->user())
2    ->cc($moreUsers)
3    ->bcc($evenMoreUsers)
4    ->queue(new OrderShipped($order));

1Mail::to($request->user())
2    ->cc($moreUsers)
3    ->bcc($evenMoreUsers)
4    ->later(now()->addMinutes(10), new OrderShipped($order));

1$message = (new OrderShipped($order))
2    ->onConnection('sqs')
3    ->onQueue('emails');
4 
5Mail::to($request->user())
6    ->cc($moreUsers)
7    ->bcc($evenMoreUsers)
8    ->queue($message);

1use Illuminate\Contracts\Queue\ShouldQueue;
2 
3class OrderShipped extends Mailable implements ShouldQueue
4{
5    // ...
6}

1Mail::to($request->user())->send(
2    (new OrderShipped($order))->afterCommit()
3);

 1<?php
 2 
 3namespace App\Mail;
 4 
 5use Illuminate\Bus\Queueable;
 6use Illuminate\Contracts\Queue\ShouldQueue;
 7use Illuminate\Mail\Mailable;
 8use Illuminate\Queue\SerializesModels;
 9 
10class OrderShipped extends Mailable implements ShouldQueue
11{
12    use Queueable, SerializesModels;
13 
14    /**
15     * Create a new message instance.
16     */
17    public function __construct()
18    {
19        $this->afterCommit();
20    }
21}

1use App\Mail\InvoicePaid;
2use App\Models\Invoice;
3 
4$invoice = Invoice::find(1);
5 
6return (new InvoicePaid($invoice))->render();

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

1Mail::to($request->user())->locale('es')->send(
2    new OrderShipped($order)
3);

 1use Illuminate\Contracts\Translation\HasLocalePreference;
 2 
 3class User extends Model implements HasLocalePreference
 4{
 5    /**
 6     * Get the user's preferred locale.
 7     */
 8    public function preferredLocale(): string
 9    {
10        return $this->locale;
11    }
12}

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

1Mail::assertQueued(OrderShipped::class);
2Mail::assertNotQueued(OrderShipped::class);
3Mail::assertNothingQueued();
4Mail::assertQueuedCount(3);

1Mail::assertSent(function (OrderShipped $mail) use ($order) {
2    return $mail->order->id === $order->id;
3});

1Mail::assertSent(OrderShipped::class, function (OrderShipped $mail) use ($user) {
2    return $mail->hasTo($user->email) &&
3           $mail->hasCc('...') &&
4           $mail->hasBcc('...') &&
5           $mail->hasReplyTo('...') &&
6           $mail->hasFrom('...') &&
7           $mail->hasSubject('...');
8});

 1use Illuminate\Mail\Mailables\Attachment;
 2 
 3Mail::assertSent(OrderShipped::class, function (OrderShipped $mail) {
 4    return $mail->hasAttachment(
 5        Attachment::fromPath('/path/to/file')
 6            ->as('name.pdf')
 7            ->withMime('application/pdf')
 8    );
 9});
10 
11Mail::assertSent(OrderShipped::class, function (OrderShipped $mail) {
12    return $mail->hasAttachment(
13        Attachment::fromStorageDisk('s3', '/path/to/file')
14    );
15});
16 
17Mail::assertSent(OrderShipped::class, function (OrderShipped $mail) use ($pdfData) {
18    return $mail->hasAttachment(
19        Attachment::fromData(fn () => $pdfData, 'name.pdf')
20    );
21});

1Mail::assertNothingOutgoing();
2 
3Mail::assertNotOutgoing(function (OrderShipped $mail) use ($order) {
4    return $mail->order->id === $order->id;
5});

 1use Illuminate\Support\Facades\Mail;
 2 
 3/**
 4 * Bootstrap any application services.
 5 */
 6public function boot(): void
 7{
 8    if ($this->app->environment('local')) {
 9        Mail::alwaysTo('[email protected]');
10    }
11}

 1use Illuminate\Mail\Events\MessageSending;
 2// use Illuminate\Mail\Events\MessageSent;
 3 
 4class LogMessage
 5{
 6    /**
 7     * Handle the given event.
 8     */
 9    public function handle(MessageSending $event): void
10    {
11        // ...
12    }
13}

 1use MailchimpTransactional\ApiClient;
 2use Symfony\Component\Mailer\SentMessage;
 3use Symfony\Component\Mailer\Transport\AbstractTransport;
 4use Symfony\Component\Mime\Address;
 5use Symfony\Component\Mime\MessageConverter;
 6 
 7class MailchimpTransport extends AbstractTransport
 8{
 9    /**
10     * Create a new Mailchimp transport instance.
11     */
12    public function __construct(
13        protected ApiClient $client,
14    ) {
15        parent::__construct();
16    }
17 
18    /**
19     * {@inheritDoc}
20     */
21    protected function doSend(SentMessage $message): void
22    {
23        $email = MessageConverter::toEmail($message->getOriginalMessage());
24 
25        $this->client->messages->send(['message' => [
26            'from_email' => $email->getFrom(),
27            'to' => collect($email->getTo())->map(function (Address $email) {
28                return ['email' => $email->getAddress(), 'type' => 'to'];
29            })->all(),
30            'subject' => $email->getSubject(),
31            'text' => $email->getTextBody(),
32        ]]);
33    }
34 
35    /**
36     * Get the string representation of the transport.
37     */
38    public function __toString(): string
39    {
40        return 'mailchimp';
41    }
42}

 1use App\Mail\MailchimpTransport;
 2use Illuminate\Support\Facades\Mail;
 3 
 4/**
 5 * Bootstrap any application services.
 6 */
 7public function boot(): void
 8{
 9    Mail::extend('mailchimp', function (array $config = []) {
10        return new MailchimpTransport(/* ... */);
11    });
12}

1'mailchimp' => [
2    'transport' => 'mailchimp',
3    // ...
4],

1composer require symfony/brevo-mailer symfony/http-client

1'brevo' => [
2    'key' => 'your-api-key',
3],

 1use Illuminate\Support\Facades\Mail;
 2use Symfony\Component\Mailer\Bridge\Brevo\Transport\BrevoTransportFactory;
 3use Symfony\Component\Mailer\Transport\Dsn;
 4 
 5/**
 6 * Bootstrap any application services.
 7 */
 8public function boot(): void
 9{
10    Mail::extend('brevo', function () {
11        return (new BrevoTransportFactory)->create(
12            new Dsn(
13                'brevo+api',
14                'default',
15                config('services.brevo.key')
16            )
17        );
18    });
19}

1'brevo' => [
2    'transport' => 'brevo',
3    // ...
4],