Laravel 使用 SwiftMailer[1] library 來處理寄信的功能,並在其上提供一個 API 讓操作更簡單。
mail 的相關設定在:
app/config/mail.php
driver 預設是 'smtp'。如果你要使用 PHP 的 mail 函式,可以改為 'mail'。其他可用的還有 'sendmail'、'mailgun'、'mandrill'及'log'。
使用 log 的話,Laravel 就不會真的寄信,而是把要寄出的信寫入 log 檔。log 檔的位置在
app/storage/logs
假設你要使用 Gmail SMTP 來寄信,設定如下:
'driver' => 'smtp',
'host' => 'smtp.gmail.com',
'port' => 587,
'username' => '你的gmail帳號',
'password' => 'gmail的密碼',
這裡有點要小心,因為你是以明碼填入你的 gmail 密碼,所以請小心防止這個檔案被查看(或是另外申請一個,絕對不要把自己常用的 gmail 帳號拿來使用)。
通常的寄信情境是,使用者填完表單後才寄送,所以在 Controller 中做驗證表單資料的動作,最後一個步驟才是寄信。
大概的程式碼會是:
//從表單取得資料
$from = ['email'=>$input['email'],
'name'=>$input['name'],
'subject'=>$input['subject']
];
//填寫收信人信箱
$to = ['email'=>'[email protected]',
'name'=>'xxx'];
//信件的內容(即表單填寫的資料)
$data = ['company'=>$input['company'],
'address'=>$input['address'],
'email'=>$input['email'],
'subject'=>$input['subject'],
'msg'=>$input['message']
];
//寄出信件
Mail::send('emails.post', $data, function($message) use ($from, $to) {
$message->from($from['email'], $from['name']);
$message->to($to['email'], $to['name'])->subject($from['subject']);
});
Mail::send() 方法第一個參數是自定的 view。第二個是要寄送的資料,第三個 function 會有一個 $message 用來指定 from 、to等資訊,如果要同時寄送副本,可以在 to 之後串接 cc:
$message->to($to['email'], $to['name'])->cc('[email protected]')
如果要在 function 中用到外部的變數,像是這個的 $from 及 $to,要使用 use(變數名稱) 。
夾帶檔案:
$message->attach('檔案路徑');
新增 app/views/emails/post.blade.php:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
</head>
<body>
<h2>{{ $subject }}</h2>
<div>{{ $msg }}</div>
<br><br>
<div><b>公司名稱:</b> {{ $company }}</div>
<div><b>公司地址:</b> {{ $address }}</div>
<div><b>email:</b> {{ $email }}</div>
</body>
</html>
資料全都由前面提到的 Mail::send() 中的 $data 所傳遞。
使用 Mail::send() 方法會在寄送完成後才返回控制權,這時候網頁看起來會像是停住了。這時候可以改用 Mail::queue(),參數都一樣,只是它會送進佇列後,在背景等待傳送,這樣就不會讓網頁看起來像是停住了。
另外,也可以用 Mail::later(10, 其餘參數相同) 來延遲寄送,參數相同,但在最前面多一個延遲秒數的參數。