Laravel集成了SwiftMailer库进行邮件发送,邮件配置文件位于config/mail.php:
return [ 'driver' => env('MAIL_DRIVER', 'smtp'), 'host' => env('MAIL_HOST', 'smtp.mailgun.org'), 'port' => env('MAIL_PORT', 587), 'from' => ['address' => null, 'name' => null], 'encryption' => env('MAIL_ENCRYPTION', 'tls'), 'username' => env('MAIL_USERNAME'), 'password' => env('MAIL_PASSWORD'), 'sendmail' => '/usr/sbin/sendmail -bs', 'pretend' => false,]
driver用于配置默认的邮件发送驱动,Laravel支持多种邮件驱动办法,包括smtp、Mailgun、Maildrill、Amazon SES、mail和sendmail,Mailgun和Amazon SES都是收费的,Maildrill目前不支持中国区用户,这三个都是第三方邮件做事。mail驱动利用PHP供应的mail函数发送,sendmail驱动通过Sendmail/Postfix(Linux)供应的命令发送邮件,smtp驱动通过支持ESMTP的SMTP发送邮件。
注:ESMTP即Extended SMTP, 是对标准 SMTP 协议进行的扩展,它与 SMTP 做事的差异仅仅是,利用 SMTP 发信不须要验证用户帐户,而用 ESMTP 发信时,做事器会哀求用户供应用户名和密码以便验证身份。
就目前状况来看,利用smtp是最明智的选择,mail不屈安,sendmail须要安装配置Sendmail/Postfix,其他要么付费要么不能用(汗!
)。下面其它配置的解释都基于driver是smtp。
接下来其他的配置都好理解,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表示上述邮箱登录对应登录密码。
sendmail是在设置driver为sendmail时利用,用于指定sendmail命令路径。
pretend用于配置是否将邮件发送记录到日志中,默认为false则发送邮件不记录日志,如果为true的话只记录日志不发送邮件,这一配置在本地开拓中调试时很有用。
根据你的邮箱做事及邮箱账号填写该配置文件,当然很多配置值须要在.env中设置。
2、定义路由
为我们的测试在routes.php定义路由规则:
Route::get('mail/send','MailController@send');
3、邮件发送逻辑实现
创建掌握器
接下来创建匹配路由的掌握器,利用如下命令创建一个干净的MailController:
php artisan make:controller MailController --plain
在app/Http/Controllers目录下天生一个新的掌握器MailController:
<?phpnamespace App\Http\Controllers;use Illuminate\Http\Request;use App\Http\Requests;use App\Http\Controllers\Controller;class MailController extends Controller{ //}
大略邮件发送实现
在该掌握器中添加邮件发送动作send(),我们利用Mail门面的send方法发送邮件,我们先发送一个最大略的邮件:
<?phpnamespace App\Http\Controllers;use Illuminate\Http\Request;use App\Http\Requests;use App\Http\Controllers\Controller;use Mail;class MailController extends Controller{ public function send() { $name = '学院君'; $flag = Mail::send('emails.test',['name'=>$name],function($message){ $to = '1072155122@qq.com'; $message ->to($to)->subject('测试邮件'); }); if($flag){ echo '发送邮件成功,请查收!
'; }else{ echo '发送邮件失落败,请重试!
'; } }}
Mail::send须要通报三个参数,第一个是邮件视图,第二个是传入视图的数据,第三个是一个闭包,该闭包中定义了收件人、抄送人(如果有的话)、邮件主题、附件等信息。邮件的主体内容位于局部视图中,下面我们就来定义这个局部视图,在resources/views/emails目录下新建test.blade.php,编辑其内容如下:
{{$name}},这是一封测试邮件
然后我们就可以在浏览器中访问http://laravel.app:8000/mail/send发送邮件,如果页面显示邮件发送成功,那么到收件人邮箱就能收到邮件了:
更大略的纯文本邮件发送
上面的示例仅仅是发送一个字符串,对付纯文本字符串邮件发送,还有更大略的方法:
Mail::raw('这是一封测试邮件', function ($message) { $to = '1072155122@qq.com'; $message ->to($to)->subject('测试邮件');});
这样的话无需创建视图即可完成邮件发送。
发送带附件的邮件(中文乱码办理)
当然,邮件内容每每不仅仅是纯文本这么大略,有时候我们会在邮件中加上附件,那么这该如何实现呢?
先上代码:
$flag = Mail::send('emails.test',['name'=>$name],function($message){ $to = '1072155122@qq.com'; $message->to($to)->subject('测试邮件'); $attachment = storage_path('app/files/test.doc'); //在邮件中上传附件 $message->attach($attachment,['as'=>'测试文档.doc']);});
从代码可知我们利用闭包中$message实例上的attach方法上传附件,该方法第一个参数是附件地址,第二个参数是一些额外参数,这里我们通过as指定附件在邮件中的显示名称。
注:须要把稳的是$message实际上是Illuminate\Mail\Message的实例,我们可以在$message上调用Message类的所有方法。
再次访问http://laravel.app:8000/mail/send发送邮件,这样在收件箱中可以看到附件,但附件名称涌现中文乱码,办理办法如下:
$message->attach($attachment,['as'=>\"大众=?UTF-8?B?\"大众.base64_encode('测试文档').\"大众?=.doc\"大众]);
通过这样处理后,就不会有中文乱码涌现了:
发送带图片的邮件
embed
除了附件之外,有时候为了让邮件内容更丰富,还会在邮件内容中插入图片,我们固然可以在邮件视图中硬编码写入图片路径,但是这显然很笨重,灵巧性很差,Laravel为我们供应了便捷方法——在视图中利用$message上的embed方法:
{{$name}},这是一封测试邮件<br><img src=\"大众{{$message->embed($imgPath)}}\公众>
这里的$message便是上述邮件发送闭包中的$message,Laravel内部自动将该变量通报到邮件视图。当然我们还须要在掌握器动作中传入$imgPath变量:
$name = '学院君';$imgPath = 'http://laravelacademy.org/wp-statics/images/carousel/LaravelAcademy.jpg';$flag = Mail::send('emails.test',['name'=>$name,'imgPath'=>$imgPath],function($message){ $to = '1072155122@qq.com'; $message->to($to)->subject('测试邮件'); $attachment = storage_path('app/files/test.doc'); //在邮件中上传附件 $message->attach($attachment,['as'=>\"大众=?UTF-8?B?\公众.base64_encode('测试文档').\公众?=.doc\"大众]);});
在浏览器中访问http://laravel.app:8000/mail/send发送邮件,邮件发送成功后去收件箱查看:
由此可见,图片已经插入到邮件内容中。
embedData
此外还支持发送原生的图片数据到邮件中,即将本地图片读取到内存然后渲染到邮件视图,这可以通过$message上的embedData实现。
首先我们修正掌握器动作如下:
$name = '学院君';//$imgPath = 'http://laravelacademy.org/wp-statics/images/carousel/LaravelAcademy.jpg';$image = Storage::get('images/test.jpg');$flag = Mail::send('emails.test',['name'=>$name,'image'=>$image],function($message){ $to = '1072155122@qq.com'; $message->to($to)->subject('测试邮件'); $attachment = storage_path('app/files/test.doc'); //在邮件中上传附件 $message->attach($attachment,['as'=>\"大众=?UTF-8?B?\"大众.base64_encode('测试文档').\"大众?=.doc\"大众]);});
记得在MailController顶部加上use Storage,然后修正邮件视图test.blade.php如下:
{{$name}},这是一封测试邮件<br><img src=\公众{{$message->embedData($image,'LaravelAcademy.jpg')}}\"大众>
末了去浏览器中访问http://laravel.app:8000/mail/send发送邮件,邮件发送成功去收件箱查看邮件内容:
同样可以成功插入图片。