yii2.0利用yii2-swiftmailer扩展发送邮件

阳光穿透心脏的1/2处 2022-06-13 14:09 360阅读 0赞

做产品或项目时，我们很多时候需要给客户发邮件。比如密码重置、各种通知。  
那么yii2.0自带的yii2-swiftmailer扩展当属我用过的最完美的扩展了。  
不得不承认，虽然yii2.0在视图里穿插各种php代码令我崩溃，但它的设计模式的确令人咋舌，各类工具也是非常齐全。  
官方文档能让我们看到这个扩展的基本用法，还是中文版的，所以我就不重复描述了。  
我要说的是，在工作中，我们应该尽量抽象好这些接口，给项目或产品提供更通用、易懂、与底层无关的接口。比如这个发信的扩展，通过我们进行一层抽象，产品中调用我们适配好的接口，既可以不用关注“yii2-swiftmailer扩展”的使用方法，另外万一扩展不靠谱，我们还可以在接口中随时替换它，而不会影响到产品中的所有代码。  
其实即使Yii的数据库操作，我们都可以扩展，没有做不到，只有我们想不到。

> 步骤一、在mail.php中（生产环境的配置，注意mail-local.php是测试环境才用到的配置）的componets数组中增加：

'mailer' => [
                'class' => 'yii\swiftmailer\Mailer',
                'useFileTransport' => false, //这句一定有，false发送邮件，true只是生成邮件在runtime文件夹下，不发邮件
                'transport' => [
                    'class' => 'Swift_SmtpTransport',
                    'host' => 'smtp.163.com', //每种邮箱的host配置不一样
                    'username' => 'xxx',
                    'password' => 'xxx',
                    'port' => '25',
                    // 'encryption' => 'tls',
                ],
                'messageConfig' => [
                    'charset' => 'UTF-8',
                    'from' => ['xxx@163.com' => '发件人姓名'],
                ],
            ],

> 步骤二、common中创建目录（就是windows中的文件夹）libs（这个名称是自定义的，也可以叫helper），libs中创建文件Email.php，其内容如下：

> 第三步、可以在各种控制器、模型层里调用了。注意一下，MVC模式开发，复杂业务逻辑都应该放到Model层，我这里只是实例而已。在SiteController.php中新增如下Action：

public function actionEmail() { 
            \Yii::$app->response->format = \yii\web\Response::FORMAT_JSON;
            $option = [
                // 'text' => '测试纯文本邮件',
                'html' => '<font color=red>测试HTML</font>',
                'tpl' => [
                    'file' => 'email_tpl.html',
                    'var' => [
                        'name' => '变量的值',
                    ],
                ],
                'subject' => '测试HTML',
                'to' => [
                    'xxx@qq.com' => 'dhn',
                    // 'xxx@163.com' => 'dhn163',
                ],
                'attachFiles' => [
                    // \Yii::getAlias('@webroot') . '/uploads/test.docx',
                ],
            ];
            $res = \common\libs\Email::sendEmail($option);
            return $res;
        }

> 步骤四、在SiteController.php的上层目录controllers所在的同级目录中创建目录mail/layouts，layouts中创建文件html.php（默认布局，跟main.php如出一辙）：

<?php $this->beginPage()?>
    <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
    <html xmlns="http://www.w3.org/1999/xhtml">
    <head>
        <meta http-equiv="Content-Type" content="text/html; charset=<?=Yii::$app->charset?>" />
        <?php $this->head()?>
    </head>
    <body>
        <?php $this->beginBody()?>
        <?=$content?>
        <div class="footer">丁华能</div>
        <?php $this->endBody()?>
    </body>
    </html>
    <?php $this->endPage()?>

> 步骤五、在mail中创建email\_tpl.html（yii渲染html是可以的，只要在render中带上后缀名）：

一切OK，访问相应的网址，就能看到json返回，如果成功，去收件箱看邮件吧，另外，配置的发件人的发件箱也能看到。

**注意：bcc在邮件的smtp协议中规定的是密送功能，比如邮件你需要通知到你的所有客户，但这些客户之间毫无联系，那么你不能发一封邮件，让大家都看到一长串的收件人。这就需要用到密送。如果是企业内部，则应该用抄送功能（信件中，所有收件人都能看到）。**