README

这是一个用于在 Phalcon 2.0 中发送邮件的便捷库。

代码从 Laravel 4 借鉴并适配了 Phalcon。

## 使用 composer 安装

在 composer.json 文件的 require 部分添加以下行

"slowprog/phalcon-mailer": "~2.0"

或者在命令行中执行

composer require slowprog/phalcon-mailer

结果大致如下

{
  "require": {
    "slowprog/phalcon-mailer": "~2.0"
  }
}

之后，在终端中执行以下命令

composer update

初始化服务

/**
 * Register Mailer Service
 */
$this->di['mailer'] = function() {
    $service = new MailerService();

    return $service->mailer();
};

或者传递参数到服务初始化阶段

/**
 * Register Mailer Service
 */
$this->di['mailer'] = function() {
    $service = new MailerService([
        'driver' => 'smtp', // mail, sendmail, smtp
        'host'   => 'smtp.email.com',
        'port'   => 587,
        'from'   => [
            'email' => 'no-reply@my-domain.com',
            'name'    => 'My Cool Company',
        ],
        'encryption' => 'tls',
        'username'   => 'no-reply@my-domain.com',
        'password'   => 'some-strong-password',
        'sendmail'   => '/usr/sbin/sendmail -bs',
        // Путь используемый для поиска шаблонов писем
        'viewsDir'   => __DIR__ . '/../app/views/', // optional
    ]);

    return $service->mailer();
};

发送邮件

以下是一个控制器的示例，但不仅限于控制器使用

$this->mailer->sendView('emails/xxx', [
    'test' => 'test' // Переменные для передачи в шаблон
], function($message) {
    $message->to('some_email@email.com');
    $message->subject('Test Email');
});

emails/xxx - 邮件模板位于 views 目录下，(app/views/emails/xxx.[phtml|volt])

默认情况下，如果容器中注册了 view 服务，库将使用它，因此可以使用任何方便的模板引擎（phtml、volt 等）

配置

默认配置需要在应用程序的配置文件 config/config.php 中指定

<?php
return new \Phalcon\Config([
    'mail' => [
        'driver' => 'smtp', // mail, sendmail, smtp
        'host'   => 'smtp.email.com',
        'port'   => 587,
        'from'   => [
            'email' => 'no-reply@my-domain.com',
            'name'    => 'My Cool Company'
        ],
        'encryption' => 'tls',
        'username'   => 'no-reply@my-domain.com',
        'password'   => 'some-strong-password',
        'sendmail'   => '/usr/sbin/sendmail -bs',
        // Путь используемый для поиска шаблонов писем
        'viewsDir'   => __DIR__ . '/../app/views/', // optional
    ],
]);

如果需要，可以将邮件配置移动到单独的配置文件中

更新。实现了使用 Phalcon 的队列服务 Beanstalk 进行延迟发送邮件的功能

队列（延迟发送邮件）

为了实现延迟发送邮件，您需要在容器中注册 queue 服务，例如

use Phalcon\Queue\Beanstalk;

$this->di['queue'] = function () {
    $queue = new Beanstalk();
    $queue->connect(); // ?

    return $queue;
};

以下是一个延迟发送邮件的示例

$this->mailer->queueView('emails/xxx', [
    'test' => 'test' // Переменные для передачи в шаблон
], function($message) {
    $message->to('some_email@email.com');
    $message->subject('Test Email');
});

所有延迟邮件都会被放入 mailer 队列中（不知道这样做是否正确）

队列处理器的示例 https://github.com/slowprog/phalcon-mailer/blob/master/example/mailer.php