構建本身的PHP框架（郵件發送）

 

完整項目地址：https://github.com/Evai/Aier

 

 

咱們採用 'nette/mail' 包做爲咱們的郵件發送基礎模塊，在它的基礎上封裝一個 'Mail' 類，暴露出簡潔的 API 給控制器使用，下面咱們正式開始。

引入 'nette/mail' 包，修改 'composer.json'：

"require": {

  "codingbean/macaw": "dev-master",

  "illuminate/database": "*",

  "filp/whoops": "*",

  "nette/mail": "*"

}

 

運行 'composer update'，等待安裝完成。'nette/mail' 的文檔位於：http://doc.nette.org/en/2.2/mailing 讓咱們閱讀它，而後設計 Mail 類：

新建 'services/Mail.php' 文件，內容以下：

<?php

use Nette\Mail\Message;

date_default_timezone_set('PRC');

/**
 * Mail
 */

class Mail

{

    public $config;

    // [String] e-mail

    protected $from;

    // [Array] e-mail list

    protected $to;

    protected $title;

    protected $body;

    protected $mail;

    /**
     * Mail constructor.
     * @param $to
     */
    function __construct($values)

    {
        $this->mail = new Message;

        $this->config = require_once BASE_PATH . '/config/mail.php';

        $this->mail->setFrom($this->config['username']);

        if ( !is_array($values) ) {

            $values = [$values];

        }

        foreach ($values as $email) {

            $this->mail->addTo($email);

        }

    }

    /**
     * 發件人
     * @param null $from
     * @return $this
     */
    public function from($from=null)

    {

        if ( !$from ) {

            throw new InvalidArgumentException("郵件發送地址不能爲空！");

        }

        $this->mail->setFrom($from);

        return $this;

    }

    /**
     * 收件人
     * @param null $to
     * @return Mail
     */
    public static function to($values=null)

    {

        if ( !$values ) {

            throw new InvalidArgumentException("郵件接收地址不能爲空！");

        }

        return new Mail($values);

    }

    /**
     * 郵件標題
     * @param null $title
     * @return $this
     */
    public function title($title=null)

    {

        if ( !$title ) {

            throw new InvalidArgumentException("郵件標題不能爲空！");

        }

        $this->mail->setSubject($title);

        return $this;

    }

    /**
     * 郵件內容
     * @param null $content
     * @return $this
     */
    public function content($content=null)

    {

        if ( !$content ) {

            throw new InvalidArgumentException("郵件內容不能爲空！");

        }

        $this->mail->setHTMLBody($content);

        return $this;

    }

    function __destruct()
    {

        $mailer = new Nette\Mail\SmtpMailer($this->config);

        $mailer->send($this->mail);

    }

}

 

Mail 類和 View 類工做的方式基本一致，在homecontroller.php中添加：

function mail()
    {
        Mail::to(['xxxxx@qq.com'])
            ->from('Evai <xxx@163.com>')
            ->title('Hello World')
            ->content('<h1>Hello World !</h1>');
        echo '發送郵件成功';
    }

 

新建 'MFFC/config/mail.php'，請自行替換郵件地址和密碼：

<?php

return [

    'host' => 'smtp.163.com',

    'username' => 'Evai <xxx@163.com>',

    'password' => 'password',

    'secure' => '',

    'context' =>  [
        'ssl' => [
           
        ],
    ],

];

 

routs.php中添加一條路由：

Route::get('mail', 'HomeController@mail');

OK，準備的差很少了，運行 'composer dump-autoload' 把 Mail 類加入自動加載，刷新頁面！

 

若是你看到以上頁面，恭喜你！郵件發送成功了！

趕快去檢查一下收件箱有木有郵件！此次頁面加載可能會稍慢，由於郵件是同步發送的。異步的隊列系統咱們會在之後講到。

分析

郵件發送的總體流程想必你們已經輕車熟路了，如今主要敘述一下 Mail 類的設計過程：

1. 郵件發送的核心參數是 '目標地址'，即郵件要發送到的 E-mail 地址，因此咱們設計 Mail::to('oo@xx.me') 做爲發送的 '觸發 API'。
2. 目前咱們採用最簡單的 'SMTP' 方式發送郵件，文檔在 這裏。配置文件放置在 'MFFC/config/mail.php' 中，依舊返回一個數組。
3. Mail 類繼承了 'Nette\Mail\Message' 類。'Mail::to()' 的時候建立一個 Mail 類的實例（對象）並返回，這時候其實 'BaseController' 中的析構函數中的代碼已經會被觸發並處理這個對象了。默認的發送人是從配置文件中讀取的 'username'。
4. 'Mail::to()' 支持 字符串 或者數組做爲參數，能夠一次發送一封或多封郵件。
5. 'from()'、'title()' 和 'content()' 方法用於豐富郵件內容。'content()' 方法能夠直接傳遞 HTML 代碼。
6. 'from()' 配置不必定都可以成功，部分郵件服務商不支持修改發送人地址。
7. 這個變量所有組裝完成後，被賦值給控制器的 '$mail' 成員變量，而後被析構函數處理，郵件被髮送，成功後頁面代碼被髮送回客戶端，流程結束。