CodeIgniter 4使用Email类发送HTML邮件的实现与问题排查

前期踩坑说明 #

• 前两次代码报语法错误的核心原因：echo是PHP直接输出内容的语言结构，没有返回值，不能写在函数参数位、赋值语句右侧，这是PHP基础语法规则问题，和CI框架无关。
• 去掉echo后收不到邮件，是缺少必要配置、未调用核心发送方法导致的，view()传第三个参数true返回渲染内容的写法本身是正确的。

正确实现步骤 #

• 第一步：修改邮件全局配置
  打开app/Config/Email.php文件，配置核心参数：

// 发件人基础信息
public $fromEmail = '你的发件邮箱账号';
public $fromName = '发件人显示名称';
// *核心配置*：指定邮件格式为HTML，默认值为text纯文本
public $mailType = 'html';
public $charset = 'utf-8';
// 按你使用的邮件服务商要求填写SMTP参数：主机地址、端口、发件账号密码、加密方式
public $protocol = 'smtp'; // 优先用SMTP协议，不要用默认的mail函数，投递成功率更高
public $SMTPHost = 'smtp.xxx.com';
public $SMTPPort = 465;
public $SMTPUser = '你的发件邮箱账号';
public $SMTPPass = '你的邮箱SMTP授权码';
public $SMTPCrypto = 'ssl';

• 第二步：控制器中调用代码

// 加载邮件服务
$email = \Config\Services::email();

// 配置邮件基础参数
$email->setTo('收件人邮箱地址');
$email->setSubject('邮件主题');
// 可选：添加附件、抄送、密送按需调用对应方法即可

// 渲染视图作为邮件正文，view第三个参数传true会返回渲染后的字符串，不需要加echo
$htmlBody = view('html_page_to_send_from_view_folder', $data, true);
$email->setMessage($htmlBody);

// 执行发送并做结果判断
if ($email->send()) {
    // 发送成功逻辑
    return '邮件发送成功';
} else {
    // 发送失败直接打印调试信息定位问题
    return $email->printDebugger();
}

收不到邮件的排查方向 #

• 确认$mailType已设置为html，纯文本模式下HTML标签会被转义，部分邮件网关会拦截格式异常的邮件
• 确认代码中调用了$email->send()方法，仅配置参数、赋值正文不会触发实际发送动作
• 本地调试时优先打印$email->printDebugger()返回的错误信息，常见问题包括SMTP授权码错误、端口被本地防火墙拦截、发件邮箱未开启SMTP服务
• 服务器部署时，优先使用SMTP协议发信，服务器自带的mail函数极易被判定为垃圾邮件，且大部分云服务商默认封禁25邮件端口
• 检查收件箱的垃圾邮件文件夹，部分初始模板内容触发垃圾邮件规则时会被自动归类

内容的提问来源于stack exchange，提问作者Seighth Hellsing