CodeIgniter 配置 SMTP 发送 HTML 邮件及注意事项

结果与目标：通过 SMTP 发送 HTML 邮件

在使用 CodeIgniter 进行开发时，内置的 Email 类库提供了便捷的邮件发送功能。为了成功发送复杂的 HTML 格式营销或通知邮件，通常需要将 protocol 设置为 smtp，并将 mailtype 设为 html。

准备条件

1. 邮箱账号：获取支持 SMTP 协议的邮箱账号（如 126、163 企业邮箱等），并确保已获得授权码或登录密码。
2. 配置文件位置：在 CodeIgniter 项目的 config/ 目录下创建或修改 email.php 文件，用于集中管理邮件服务配置。

真实操作顺序

第1步：配置 SMTP 参数

目的：让框架知道如何连接邮件服务器及验证身份。

入口：编辑 application/config/email.php。

动作：定义邮件相关的全局配置数组。关键参数说明：

• protocol: 设置为 'smtp'，指定使用 SMTP 协议而非默认的 mail/sendmail。
• smtp_host: SMTP 服务器地址，例如 'smtp.126.com'。
• smtp_user 和 smtp_pass: 你的邮箱账号和密码（建议测试时使用专用账号）。如果是网易系邮箱，部分情况下可能需要使用授权码。
• smtp_port: 常见端口为 25，若使用 SSL/TLS 加密则可能为 465 或 587，需根据服务商要求调整。
• charset: 推荐设置为 'utf-8' 以保证中文显示正常。
• mailtype: 设置为 'html'，告知 CI 发送的是 HTML 格式邮件。
• wordwrap: 设为 TRUE，启用自动换行。

<?php
if ( ! defined('BASEPATH')) exit('No direct script access allowed');

/* 
|------------------------------------ 
| Email Config 
|------------------------------------ 
*/ 
$config['protocol'] = 'smtp';
$config['smtp_host'] = 'smtp.126.com';
$config['smtp_user'] = 'your_email@126.com';
$config['smtp_pass'] = 'your_password_or_auth_code';
$config['smtp_port'] = '25';
$config['charset'] = 'utf-8';
$config['wordwrap'] = TRUE;
$config['mailtype'] = 'html';
?>

第2步：处理并发送 HTML 邮件内容

目的：确保 HTML 字符串在通过 CI Email 类发送时不被转义破坏，特别是去除可能导致解析错误的双引号。

入口：控制器中使用 $this->email->send() 前。

动作：在将 HTML 消息传递给 CI 之前，建议对包含双引号的变量进行处理。CI 内部可能会自动添加转义，若原始 HTML 已包含双引号，直接传入可能会导致 HTML 结构混乱或内容被截断。

// 假设 $msg 是你构建好的 HTML 邮件内容字符串
// 移除所有双引号，防止与 CI 内部使用的引号冲突
$send_msg = str_replace('"', '', $msg);

$this->email->from('your@example.com', 'Sender Name');
$this->email->to('recipient@example.com');
$this->email->subject('Test HTML Email');
$this->email->message($send_msg);
$this->email->send();

第3步：开启调试模式排查问题

目的：方便查看邮件发送的具体状态和错误信息，避免因静默失败而难以定位问题。

入口：代码执行过程中。

动作：在执行 $this->email->send() 后，检查返回值。若返回 false，调用 $this->email->print_debugger() 输出详细的 SMTP 握手和发送日志。

完成判断与风险提示

如果控制台无报错且数据库日志记录了发送成功，或者收件箱收到带有样式的 HTML 邮件，即表示配置正确。但需注意，如果使用个人免费邮箱（如 126、163）进行大量或高频对外发送邮件，极易被判定为垃圾邮件发送者，从而导致账号被封禁（Ban）。生产环境建议使用专门的企业邮箱或第三方邮件推送服务（如 SendGrid、AWS SES）。

简要总结

以上是对 CodeIgniter 使用 SMTP 发送 HTML 邮件的详细配置与操作步骤。关键点在于正确配置 email.php 中的 SMTP 主机与凭证，并在发送前对 HTML 内容进行引号清洗，同时警惕免费邮箱的频率限制。更多关于 CodeIgniter 高级用法及 PHP 开发技巧的资料请关注本站其它相关文章！