转自王宝花http://www.jianshu.com/p/8ccb2820df23
此教程是笔者通过laravel学院的教程的学习总结,总结了几个错误,以及laravel学院中没讲到的点。laravel学院真心不错,推荐给大家。
laravel自带SwiftMailer库,集成了多种邮件API,可以很方便的实现邮件的发送。在本教程中使用到的是SMTP(Simple Message Transfer Protocol)简单邮件传输协议,通常理解为邮件发送服务器。
实验使用邮箱的163,QQ邮箱
需要注意的是:使用QQ邮箱的话,需要开启POP3和SMTP服务。开启方式如下:
QQ邮箱 > 设置 > 账户
当开启成功会生成密钥,这个东西会在配置中用到
开始进行配置
我试验的laravel项目名称为《laravel》
# 编辑邮件配置文件
$ vim laravel/config/mail.php
# mail.php
return [
'driver' => env('MAIL_DRIVER', 'smtp'),
'host' => env('MAIL_HOST', 'smtp.163.com'),
'port' => env('MAIL_PORT', 25),
'from' => ['address' => '18010029423@163.com','name' => '发件人'],
'encryption' => env('MAIL_ENCRYPTION', 'tls'),
'username' => env('MAIL_USERNAME'),
'password' => env('MAIL_PASSWORD'),
'sendmail' => '/usr/sbin/sendmail -bs',
]
# 编辑环境配置文件
vim laravel/.env
#.env
MAIL_DRIVER=
MAIL_HOST=
MAIL_PORT=
MAIL_USERNAME=yourname@163.com
MAIL_PASSWORD=password
MAIL_ENCRYPTION=
.env文件需要配置username和password其余为空,则会使用mail.php的配置。
-
driver
用于配置默认的邮件发送驱动,Laravel支持多种邮件驱动方式,包括smtp、Mailgun、Maildrill、Amazon SES、mail和sendmail,Mailgun和Amazon SES都是收费的Maildrill目前不支持中国区用户,这三个都是第三方邮件服务。mail驱动使用PHP提供的mail函数发送,sendmail驱动通过Sendmail/Postfix(Linux)提供的命令发送邮件,smtp驱动通过支持ESMTP的SMTP发送邮件。
就目前状况来看,使用smtp是最明智的选择,mail不安全,sendmail需要安装配置Sendmail/Postfix,其他要么付费要么不能用。
2.host
是邮箱所在主机,比如我们使用163邮箱,对应值是smtp.163.com
,使用QQ邮箱的话,对应值是smtp.qq.com
。 -
port
用于配置邮箱发送服务端口号,比如一般默认值是25,但如果设置SMTP使用SSL加密,该值为465。 -
from
配置项包含address和name,前者表示发送邮箱,后者表示发送邮件使用的用户名。 -
encryption
表示加密类型,可以设置为null表示不使用任何加密,也可以设置为tls或ssl。 -
username
表示邮箱账号,比如yaojinbu@163.com -
password
表示上述邮箱登录对应登录密码。注意QQ邮箱的话应该开启POP3|SMTP服务时给的密钥。 -
sendmail
是在设置driver为sendmail时使用,用于指定sendmail命令路径。
开始编写控制器、路由、模板。
在路由中加入如下规则:
Route::get('mail/send','MailController@send');
生成控制器
php artisan make::controller MailController
在laravel/app/Http/Controllers生成了一个MailController控制器,如下所示:
# MailController.php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use App\Http\Requests;
use App\Http\Controllers\Controller;
class MailController extends Controller{
//
}
编辑控制器,加入以下的逻辑处理
use Mail;
class MailController{
public function send(){
$name = '王宝花';
$flag = Mail::send('emails.test',['name'=>$name],function($message){
$to = '282584778@qq.com';
$message ->to($to)->subject('邮件测试');
});
if($flag){
echo'发送邮件成功,请查收!';
}else{
echo'发送邮件失败,请重试!';
}
}
}
Mail::send();需要传三个参数,第一个为引用的模板,第二个为给模板传递的变量,第三个为一个闭包,参数绑定Mail类的一个实例。
在resources/emails下创建一个模板文件。
# test.blade.php
{{$name}}你好,这是一封测试文件。
好,现在在服务器上进行测试了,在地址栏输入http://wbl.app/mail/send
,发送成功。
错误解决
- 页面无异常输出,显示500的错误,是服务器的问题,如果是Nginx的则检查
/var/log/nginx/errors.log;
如果是apache则检查/usr/local/apache2/logs/error.log
,然后根据提示解决就行,permission的问题话就应该是storage的权限问题。 - 页面有报错,根据报错解决即可,一般都是语法格式或者是没有使用正确命名空间。
发送纯文本邮件
Mail::raw('你好,我是PHP程序!', function($message){
$to = '282584778@qq.com';
$message ->to($to)->subject('纯文本信息邮件测试');
});
邮件中发送附件
- 网络图片
当然,可以在模板直接应用静态文件;但灵活性差,使用embed方法更灵活。
# test.blade.php
{{$name}}你好,这是一封测试文件。
<br>
<img src='{{$message->embed($image)}}'
>
publicfunctionsend(){
$name = '王宝花';
$image = 'http://d.hiphotos.baidu.com/zhidao/pic/item/1ad5ad6eddc451da4ab93e2bb0fd5266d11632a6.jpg';
$flag = Mail::send('emails.test',['name'=>$name,'imgPath'=>$image],function($message){
$to = '282584778@qq.com';
$message ->to($to)->subject('网络图片测试');
});
if($flag){
echo'发送邮件成功,请查收!';
}else{
echo'发送邮件失败,请重试!';
}}
现在在服务器上进行测试了,在地址栏输入http://wbl.app/mail/send
- 本地图片
本地图片引用需要使用到Storage类,模板方法略有不同,在Storage/images文件夹中有一张图片。
embedData()两个参数,第一个为图片,第二个为自定义图片名称。
# test.blade.php
{{$name}},这是一封测试邮件
<br>
<img src="{{$message->embedData($image,'我的自拍照.jpg')}}">
# MailController.php
public functionsend(){
$image = Storage::get('images/obama.jpg');
$flag = Mail::send('emails.test',['image'=>$image],function($message){
$to = '282584778@qq.com';
$message->to($to)->subject('[本地图片测试]');
});
if($flag){
echo'发送邮件成功,请查收!';
}else{
echo'发送邮件失败,请重试!';
}
}
邮件附件
public functionsendFile(){
$name = '王宝花';
$flag = Mail::send('emails.test',['name'=>$name],function($message){
$to = '282584778@qq.com';
$message->to($to)->subject('邮件主题');
$attachment = storage_path('app/files/test.txt');
// 在邮件中上传附件
$message->attach($attachment,['as'=>'中文文档.txt']);
});
}
$message的attach方法上传附件,该方法第一个参数是附件地址,第二个参数为一些额外参数,这里我们通过as指定附件在邮件中的显示名称。
测试如果显示文件名乱码的话,就这样写
$message->attach($attachment,['as'=>"=?UTF-8?B?".base64_encode('中文文档')."?=.txt"]);