CodeIgniter 4 中使用 HTML 模板发送邮件的完整教程-php教程-PHP中文网

CodeIgniter 4 中使用 HTML 模板发送邮件的完整教程

本文详解如何在 codeigniter 4 中正确调用视图生成 html 邮件内容，并通过 email 类发送，避免常见语法错误与静默失败问题。

本文详解如何在 codeigniter 4 中正确调用视图生成 html 邮件内容，并通过 email 类发送，避免常见语法错误与静默失败问题。

在 CodeIgniter 4 中发送 HTML 格式邮件是常见需求，但其语法与 CI3 有本质区别：CI4 的 view() 辅助函数返回字符串而非直接输出，且不支持 echo 在表达式中使用——这正是你遇到 syntax error, unexpected echo(T_ECHO) 的根本原因。

✅ 正确做法是：先渲染视图并赋值给变量，再传入 setMessage()。如下所示：

Wechat HTML Publisher

直接上传HTML富文本到微信公众号草稿箱。支持完整的HTML格式,无需Markdown转换。

下载

use CodeIgniter\Email\Email;

// 1. 渲染 HTML 视图（注意：第三个参数 true 表示返回字符串，非直接输出）
$htmlContent = view('emails/welcome_email', [
    'name'  => 'Alice',
    'token' => 'abc123xyz'
], ['debug' => false]); // 可选：禁用调试上下文避免意外输出

// 2. 初始化并配置 Email 实例
$email = \Config\Services::email();
$email->setFrom('no-reply@yourapp.com', 'Your App');
$email->setTo('user@example.com');
$email->setSubject('欢迎注册！');
$email->setMessage($htmlContent); // ✅ 正确：传入已渲染的 HTML 字符串

// 3. 发送邮件（务必检查返回值！）
if ($email->send()) {
    echo '邮件发送成功！';
} else {
    // ⚠️ 关键：获取并记录错误信息，避免“无报错却无邮件”的静默失败
    $error = $email->printDebugger(['headers']);
    log_message('error', 'Email send failed: ' . $error);
    echo '发送失败，请检查日志。';
}

? 注意事项与最佳实践：

视图路径需正确：view('emails/welcome_email') 对应 app/Views/emails/welcome_email.php；确保文件存在且无 PHP 语法错误。
不要在 view() 前加 echo：echo view(...) 是非法语法（导致 T_ECHO 错误），view() 本身即返回字符串。
启用 HTML 模式（可选但推荐）：若邮件客户端未自动识别 HTML，可显式设置：
```
$email->setHeader('Content-Type', 'text/html; charset=utf-8');
```
调试静默失败：$email->send() 返回 bool，失败时务必调用 $email->printDebugger() 查看完整错误（如 SMTP 连接失败、未配置邮箱驱动等）。
安全提醒：HTML 邮件中的用户数据（如 $data['name']）建议使用 esc() 过滤，防止 XSS（尤其当内容来自用户输入时）：
```
'name' => esc($userData['name'])
```