Yii设置邮箱发文件的方法

冰川箭仙 2025-12-04 00:00:00 次阅读

Yii框架需借助yii2-swiftmailer扩展实现邮件发送，配置mailer组件并设置SMTP参数，通过attach()或attachContent()添加附件，注意路径、编码及授权码等细节。

Yii 框架本身不直接提供邮件发送功能，需借助第三方扩展（如 yii2-swiftmailer）实现发邮件，包括带附件的邮件。以下是基于 Yii2 官方推荐方式的实用配置与发送方法。

安装并配置 swiftmailer 扩展

在项目根目录执行：

composer require --prefer-dist yiisoft/yii2-swiftmailer

然后在 config/web.php 或 config/main.php 的 components 中添加配置：

'mailer' => [
    'class' => 'yii\swiftmailer\Mailer',
    'viewPath' => '@app/mail',
    'useFileTransport' => false, // 设为 false 才真正发邮件
    'transport' => [
        'class' => 'Swift_SmtpTransport',
        'host' => 'smtp.gmail.com',     // 如使用 QQ 邮箱则填 smtp.qq.com
        'username' => 'your_email@gmail.com',
        'password' => 'your_app_password', // 注意：Gmail 需用「应用专用密码」，QQ 邮箱需开启 SMTP 并获取授权码
        'port' => 587,
        'encryption' => 'tls',
    ],
],

在控制器中发送带附件的邮件

附件可以是本地文件路径、临时文件或内存中的内容。关键点是使用 attach() 方法：

附加本地文件：传入绝对路径即可
附加内存内容：用 attachContent()，适合动态生成的 PDF、CSV 等
注意文件名和 MIME 类型：尤其是非标准后缀时建议显式指定

示例代码：

$message = \Yii::$app->mailer->compose()
    ->setFrom(['admin@example.com' => '网站系统'])
    ->setTo('user@example.com')
    ->setSubject('您的订单附件')
    ->setTextBody('这是一封带附件的测试邮件')
    ->setHtmlBody('请查收附件：order.pdf');

// 添加本地文件附件（绝对路径）
$message->attach('/path/to/order.pdf');

// 或添加内存中的 CSV 内容
$csvContent = "name,age\nAlice,25\nBob,30";
$message->attachContent($csvContent, [
    'fileName' => 'data.csv',
    'contentType' => 'text/csv',
]);

$message->send();

常见问题与注意事项

附件路径必须是服务器可读的绝对路径，相对路径容易失败
大文件可能触发内存限制或超时，建议压缩或分片，或改用云存储链接方式
中文文件名乱码：Swift Mailer 默认不支持 UTF-8 文件名，可先用 mb_convert_encoding() 转换，或改用英文名+中文描述
开发环境调试：设 'useFileTransport' => true 后邮件会保存在 @runtime/mail 目录，方便查看原始内容