寄信

介紹

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

假設你要使用 Gmail SMTP 來寄信,設定如下:

'driver' => 'smtp',
'host' => 'smtp.gmail.com',
'port' => 587,
'username' => '你的gmail帳號',
'password' => 'gmail的密碼',

這裡有點要小心,因為你是以明碼填入你的 gmail 密碼,所以請小心防止這個檔案被查看(或是另外申請一個,絕對不要把自己常用的 gmail 帳號拿來使用)。

寄信

通常的寄信情境是,使用者填完表單後才寄送,所以在 Controller 中做驗證表單資料的動作,最後一個步驟才是寄信。

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('檔案路徑');

View 的部份

新增 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, 其餘參數相同) 來延遲寄送,參數相同,但在最前面多一個延遲秒數的參數。