Yii框架的邮件队列怎么实现_结合queue异步发送邮件【教程】-YII-PHP中文网

根本原因是队列工作进程未运行或邮件任务未正确入队；需执行php yii queue/listen启动常驻进程，任务类须继承yii\base\Object并实现execute()方法，内部重建Mailer实例，避免依赖Yii::$app。

yii框架的邮件队列怎么实现_结合queue异步发送邮件【教程】

Yii2 中用 `yii\queue` 发邮件为什么没反应？

根本原因通常是队列驱动没真正跑起来，或者邮件任务没正确推入队列。Yii 的 yii\queue 本身不执行任务，它只负责存任务、发信号；你得单独启一个工作进程来消费队列（比如用 php yii queue/listen），否则任务永远卡在数据库或 Redis 里。

常见错误现象：queue push 返回 ID，但邮箱收不到信，日志里也没报错；查数据库发现 queue 表有记录但 done_at 始终为空。

确认已安装并配置好具体驱动（如 db 或 redis），不能只装扩展不配 components['queue']
运行 php yii queue/listen 后别关终端——它是个常驻进程，不是“执行一次就完”
若用 db 驱动，确保 yii\queue\db\Queue 对应的表已通过 yii migrate --migrationPath=@yii/queue/migrations 创建

怎么写一个可进队列的邮件任务类？

必须继承 yii\base\Object 并实现 execute() 方法，且不能依赖 $this->mailer 这类 Yii 组件实例——因为队列任务是在无 Web 上下文的 CLI 进程中执行的，Yii::$app 不可用。

典型做法是把邮件参数序列化传入，任务类内部重新构建 Mailer 实例或直接调用底层发送逻辑。

不要在构造函数里调用 Yii::$app->mailer，改在 execute() 里用配置数组初始化新实例
参数尽量精简：收件人、主题、文本内容、是否 HTML，避免传整个 ActiveRecord 对象（序列化可能失败或超限）

示例结构：

class SendEmailJob extends \yii\base\Object implements \yii\queue\JobInterface
{
    public $to;
    public $subject;
    public $html;
<pre class="brush:php;toolbar:false;">public function execute($queue)
{
    $mailer = \Yii::createObject([
        'class' => 'yii\swiftmailer\Mailer',
        'transport' => ['class' => 'Swift_SmtpTransport', /* ... */],
    ]);
    $mailer->compose()
        ->setTo($this->to)
        ->setSubject($this->subject)
        ->setHtmlBody($this->html)
        ->send();
}

}

Yii Framework 2.0.51

Yii Framework 2.0.51 官方 Basic 应用模板，适合旧项目兼容、升级验证和开发测试。

下载

为什么发邮件时提示 `Class 'Swift_SmtpTransport' not found`？

这是环境不一致导致的：Web 请求时自动加载了 swiftmailer/swiftmailer，但 CLI 下 Composer autoloader 没被正确引入，尤其在某些部署方式（如 Supervisor 管理队列进程）中容易漏掉 vendor/autoload.php。

检查 php yii queue/listen 执行时的 PHP include_path 和当前工作目录，确保它和 Web 入口一样能加载到 vendor/autoload.php
如果用的是自定义入口脚本启动队列，务必在开头加上 require __DIR__ . '/vendor/autoload.php';
避免在任务类中用 new Swift_SmtpTransport()，改用 Yii::createObject() + 配置数组，让 DI 容器统一管理依赖

队列发邮件比同步慢很多，怎么优化？

慢通常不是因为队列本身，而是任务设计不合理：比如每次发一封都重建 SMTP 连接、没启用连接复用、或者把大附件塞进序列化参数里。

SMTP 连接默认是短连，可在 transport 配置中加 'streamOptions' => ['ssl' => ['verify_peer' => false]]（仅测试环境）并开启 'pingThreshold' => 30 复用连接
附件不要 base64 后塞进任务属性，改用临时文件路径 + 任务内读取，或提前上传到对象存储后传 URL
批量发送别用“循环 push 单封”，改用一个任务处理多封（如 public $batch = []），减少队列 I/O 次数

队列发邮件最易被忽略的点是：任务类的生命周期完全独立于 Web 请求，所有外部依赖（数据库连接、邮件服务、文件系统）都得在 execute() 内显式准备，而不是想当然地复用当前请求上下文里的东西。