3分钟搞定！CodeIgniter邮件发送全攻略：从配置到高级功能实现
项目地址: https://gitcode.com/gh_mirrors/co/CodeIgniter 你还在为PHP邮件发送调试几小时？本文带你一文掌握CodeIgniter邮件类的全部技巧，5分钟搭建稳定邮件系统，解决90%的邮件发送难题！读完你将学会：SMTP服务器配置、HTML邮件编写、附件发送、批量邮件优化，以及错误排查的实用技巧。
快速上手：基础邮件发送示例
CodeIgniter的Email类封装了复杂的邮件协议细节，只需简单几步即可发送邮件。以下是一个最基础的发送示例，位于application/controllers/Welcome.php控制器中：
public function send_email()
{
$this->load->library('email'); // 加载邮件库
// 配置发件人信息
$this->email->from('your@example.com', '你的名称');
$this->email->to('recipient@example.com'); // 收件人
$this->email->subject('CodeIgniter邮件测试');
$this->email->message('这是使用CodeIgniter Email类发送的测试邮件');
if (!$this->email->send()) {
show_error($this->email->print_debugger()); // 调试错误信息
} else {
echo '邮件发送成功！';
}
}
三种发送协议配置指南
CodeIgniter支持mail、sendmail和SMTP三种发送协议，其中SMTP是最推荐的方式，支持加密和认证，成功率更高。
SMTP协议配置（推荐）
编辑application/config/email.php配置文件（若不存在请新建），添加以下SMTP配置：
$config['protocol'] = 'smtp';
$config['smtp_host'] = 'smtp.qq.com'; // QQ邮箱SMTP服务器
$config['smtp_user'] = 'your_qq_email@qq.com'; // 邮箱账号
$config['smtp_pass'] = 'your_authorization_code'; // 授权码而非密码
$config['smtp_port'] = 465; // SSL端口
$config['smtp_crypto'] = 'ssl'; // 加密方式
$config['charset'] = 'utf-8';
$config['mailtype'] = 'html'; // 支持HTML邮件
注意：QQ邮箱需要在设置中开启SMTP服务并获取授权码，其他邮箱如163、Gmail配置类似，具体参数请查阅对应邮箱的帮助文档。
配置优先级说明
Email类的配置有三种方式，优先级从高到低为：
- 动态配置：通过
initialize()方法传入数组 - 配置文件：
application/config/email.php - 默认配置：系统内置的默认值
动态配置示例：
$config = array(
'protocol' => 'smtp',
'smtp_host' => 'smtp.gmail.com',
'smtp_port' => 587,
'smtp_crypto' => 'tls'
);
$this->email->initialize($config);
高级功能实战
HTML格式邮件与替代文本
要发送HTML邮件，需将mailtype设置为html，并可选择提供纯文本替代内容：
$this->email->set_mailtype('html');
$this->email->message('<h1>欢迎使用CodeIgniter</h1><p>这是一封<b>HTML格式</b>的邮件</p>');
// 设置纯文本替代内容（供不支持HTML的邮件客户端）
$this->email->set_alt_message('欢迎使用CodeIgniter\n\n这是一封纯文本邮件');
附件发送与内联图片
Email类支持多种附件类型，包括本地文件、URL和二进制数据：
// 发送本地文件
$this->email->attach(APPPATH.'uploads/report.pdf');
// 发送网络文件
$this->email->attach('https://example.com/image.jpg');
// 发送二进制数据（如生成的PDF）
$this->email->attach($pdf_content, 'attachment', 'invoice.pdf', 'application/pdf');
内联图片发送需使用attachment_cid()方法：
$cid = $this->email->attachment_cid(APPPATH.'images/logo.png');
$this->email->message('<img src="cid:'.$cid.'" alt="Logo">');
批量邮件发送优化
当需要发送大量邮件时，使用BCC批量模式可显著提高效率：
$config['bcc_batch_mode'] = TRUE;
$config['bcc_batch_size'] = 100; // 每批发送100封
$this->email->bcc($large_recipient_list); // 传入收件人数组
$this->email->send();
循环发送个性化邮件时，需使用clear()方法重置：
foreach ($users as $user) {
$this->email->clear(); // 重置邮件参数
$this->email->to($user['email']);
$this->email->subject('欢迎你，'.$user['name']);
$this->email->message('个性化内容...');
$this->email->send();
}
错误排查与调试技巧
启用调试模式
发送邮件失败时，使用print_debugger()方法获取详细调试信息：
if (!$this->email->send(FALSE)) { // 传递FALSE参数保留邮件数据
echo $this->email->print_debugger(); // 输出调试信息
}
调试信息包含：
- 服务器响应日志
- 邮件头信息
- 邮件主题和正文
- 附件信息
常见错误解决方案
- SMTP认证失败：检查账号密码是否正确，特别是授权码是否过期
- 连接超时：确认SMTP服务器地址和端口是否正确，防火墙是否允许出站连接
- 邮件被标记为垃圾邮件：确保发件人地址与SMTP服务器域名一致，添加正确的邮件头和退订链接
- 中文乱码：设置
charset为utf-8，并确保内容编码正确
完整功能参考与资源
Email类核心方法速查表
| 方法 | 用途 | 示例 |
|---|---|---|
from($email, $name) | 设置发件人 | $this->email->from('a@example.com', 'A') |
to($email) | 设置收件人 | $this->email->to('b@example.com') |
subject($text) | 设置主题 | $this->email->subject('测试') |
message($text) | 设置正文 | $this->email->message('内容') |
attach($file) | 添加附件 | $this->email->attach('file.pdf') |
send() | 发送邮件 | $this->email->send() |
print_debugger() | 获取调试信息 | echo $this->email->print_debugger() |
官方文档与扩展资源
- 官方文档：system/libraries/Email.php 类源码注释
- 配置示例：user_guide_src/source/libraries/email.rst
- 测试用例：tests/codeigniter/libraries/Email_test.php
通过本文的指南，你已经掌握了CodeIgniter邮件发送的全部核心技能。无论是简单的通知邮件，还是复杂的营销邮件，都能通过Email类轻松实现。记住，邮件发送的稳定性不仅取决于代码，还与服务器配置和收件人邮箱政策密切相关，建议在生产环境中使用专业的第三方邮件服务如SendGrid或Mailgun以获得更高的送达率。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
