Through the with method

If you want to customize the format of the email data before the data is sent to the template, you can manually pass the data to the view via the with method . Normally, you still need to pass data through the constructor of the mailable class, but this time you need to set the data to the protected or private attribute, so that the data will not Automatically takes effect in the view. Then, when the with method is called, pass the array data to the method so that the data takes effect in the view template:

<?php
    namespace App\Mail;
    use App\Order;
    use Illuminate\Bus\Queueable;
    use Illuminate\Mail\Mailable;
    use Illuminate\Queue\SerializesModels;
    class OrderShipped extends Mailable{ 
       use Queueable, SerializesModels;   
     /**
     * 订单实例.
     *
     * @var Order
     */ 
   protected $order;  
    /**
     * 创建一个新的实例.
     *
     * @return void
     */  
   public function __construct(Order $order)  
     {     
        $this->order = $order;  
      }   
    /**
     * 构建消息.
     *
     * @return $this
     */  
    public function build()  
      {     
         return $this->view('emails.orders.shipped')                
             ->with([                 
                    'orderName' => $this->order->name,                        
                    'orderPrice' => $this->order->price,                 
                    ]);  
           }
      }

After the data is passed to the view through the with method, will automatically take effect in the view, so you can also access the passed data just like accessing other data in the Blade template:

<div>
    Price: {{ $orderPrice }}
</div>

Attachment

To add an attachment to an email, use the attach method in the build method. The attach method accepts the absolute path to the file as its first argument:

    /**
     * Build the message.
     *
     * @return $this
     */    
     public function build()   
      {      
        return $this->view('emails.orders.shipped')                 
           ->attach('/path/to/file');  
      }

When attaching a file to a message, you can also pass an array to attach method as the second parameter to specify the display name and/or MIME type:

    /**
     * Build the message.
     *
     * @return $this
     */  
   public function build()  
    {      
      return $this->view('emails.orders.shipped')                
          ->attach('/path/to/file', [                        
                                          'as' => 'name.pdf',                       
                                           'mime' => 'application/pdf',       
                                     ]);  
     }

Add attachment from disk

If you have If a file is stored on storage, you can attach it to an email using the attachFromStorage method:

/**
 * 构建消息。
 *
 * @return $this
 */
 public function build(){
    return $this->view('email.orders.shipped')             
      ->attachFromStorage('/path/to/file');
 }

If necessary, you can use the attachFromStorage method The second and third parameters specify the file attachment name and other options:

/**
 * 构建消息。
 *
 * @return $this
 */
 public function build(){ 
   return $this->view('email.orders.shipped')            
      ->attachFromStorage('/path/to/file', 'name.pdf', [               
          'mime' => 'application/pdf'             
       ]);
    }

If you need to specify a storage disk other than the default disk, you can use the attachFromStorageDisk method:

/**
 * 构建消息。
 *
 * @return $this
 */
 public function build(){
    return $this->view('email.orders.shipped')            
       ->attachFromStorageDisk('s3', '/path/to/file');
   }

Raw data attachment

attachData You can use byte data as an attachment. For example, you can use this method to attach a PDF to an email that is generated in memory but not saved to disk. attachData The first parameter of the method receives raw byte data, the second parameter is the file name, and the third parameter accepts an array to specify other parameters:

    /**
     * Build the message.
     *
     * @return $this
     */
   public function build()  
     {     
        return $this->view('emails.orders.shipped')                
            ->attachData($this->pdf, 'name.pdf', [                   
                 'mime' => 'application/pdf',                
                ]);  
         }

Inline Attachments

Embedding inline images in emails is often cumbersome; however, Laravel provides a way to attach images to emails and obtain the appropriate CID Easy way. Inline images can be embedded using the embed method of the $message variable in the email template. Laravel automatically makes the $message variable available in all email templates, no need to worry about passing it manually:

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

{note} $message in the text Not available in Messages because text messages cannot use inline attachments.

Embed original data attachment

If you already have the original data string that you want to embed in the email template, you can use the embedData method of the $message variable:

<body>
    Here is an image from raw data:
        <img src="{{ $message->embedData($data, $name) }}">
</body>

MailablewithSwiftMessage method of base class Allows you to register a callback that will be called before sending the message, with the original SwiftMailer message as the argument to the callback:

/**
 * 构建消息。
 *
 * @return $this
 */
 public function build(){
     $this->view('emails.orders.shipped');    
     $this->withSwiftMessage(function ($message) {    
         $message->getHeaders()             
            ->addTextHeader('Custom-Header', 'HeaderValue');   
     });
}

--markdown option make:mail Artisan command:

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

build method, calling markdown method instead of view method. markdown The method accepts the Markdown template name and an optional array of available names in the template:

/**
 * Build the message.
 *
 * @return $this
 */
 public function build(){ 
    return $this->from('example@example.com')            
        ->markdown('emails.orders.shipped');
   }

@component('mail::message')
# 订单已发货
Your order has been shipped!
@component('mail::button', ['url' => $url])
View Order
@endcomponent
Thanks,<br>
{{ config('app.name') }}
@endcomponent

{tip} Do not use when writing Markdown emails Extra indentation. The Markdown parser will render the indented content into code blocks.

url and optionally color. Color options support primary, success, and error. You can add as many button components to the message as you like:

@component('mail::button', ['url' => $url, 'color' => 'success'])
View Order
@endcomponent

@component('mail::panel')
This is the panel content.
@endcomponent

@component('mail::table')
| Laravel       | Table         | Example  |
| ------------- |:-------------:| --------:|
| Col 2 is      | Centered      |       |
| Col 3 is      | Right-Aligned |       |
@endcomponent

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

<?php
    namespace App\Http\Controllers;
    use App\Order;use App\Mail\OrderShipped;
    use Illuminate\Http\Request;
    use Illuminate\Support\Facades\Mail;
    use App\Http\Controllers\Controller;
    class OrderController extends Controller{   
     /**
     * 发送给定的订单。
     *
     * @param  Request  $request
     * @param  int  $orderId
     * @return Response
     */  
       public function ship(Request $request, $orderId)  
         {      
           $order = Order::findOrFail($orderId);        
           // 发送订单...        
           Mail::to($request->user())->send(new OrderShipped($order));  
           }
     }

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

$invoice = App\Invoice::find(1);
return (new App\Mail\InvoicePaid($invoice))->render();

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

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

$when = now()->addMinutes(10);Mail::to($request->user())  
              ->cc($moreUsers)    
              ->bcc($evenMoreUsers)    
              ->later($when, new OrderShipped($order));

$message = (new OrderShipped($order))        
        ->onConnection('sqs')                
        ->onQueue('emails');Mail::to($request->user())    
        ->cc($moreUsers)    
        ->bcc($evenMoreUsers)    
        ->queue($message);

use Illuminate\Contracts\Queue\ShouldQueue;
class OrderShipped extends Mailable implements ShouldQueue{ 
   //
 }

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

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

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

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

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