在 OpenCart 3.x 中，直接使用 PHP 原生 mail() 函数发送邮件已不再推荐且常失败；应改用框架内置的 Mail 类并正确配置 SMTP 或 mail 引擎参数，确保兼容性、编码安全与可靠性。
在 opencart 3.0.2.0 中，直接使用 php 原生 `mail()` 函数发送邮件已不再推荐且常失败；应改用框架内置的 `mail` 类并正确配置 smtp 或 mail 引擎参数，确保兼容性、编码安全与可靠性。
OpenCart 3.x 对邮件发送机制进行了重构，弃用了简单的 mail() 调用，转而依赖统一的 Mail 类（位于 system/library/mail.php），该类支持多种传输引擎（如 mail、smtp、sendmail），并内置了字符编码处理、HTML 渲染、头部安全校验等功能。直接调用 mail() 不仅绕过框架配置（如后台设置的 SMTP 凭据或发信人信息），还易因换行符格式（\r\n vs \n）、UTF-8 编码未转义、邮箱地址被 Cloudflare 邮箱保护（__cf_email__）等导致发送失败或乱码。
✅ 正确做法：使用 OpenCart 3 的 Mail 实例，并严格遵循其初始化流程：
// 创建 Mail 实例（自动读取后台邮件配置）
$mail = new Mail($this->config->get('config_mail_engine'));
// 设置通用参数（根据 config_mail_engine 自动适配）
$mail->parameter = $this->config->get('config_mail_parameter');
$mail->smtp_hostname = $this->config->get('config_mail_smtp_hostname');
$mail->smtp_username = $this->config->get('config_mail_smtp_username');
$mail->smtp_password = html_entity_decode($this->config->get('config_mail_smtp_password'), ENT_QUOTES, 'UTF-8');
$mail->smtp_port = $this->config->get('config_mail_smtp_port');
$mail->smtp_timeout = $this->config->get('config_mail_smtp_timeout');
// 设置收件人、发件人及元信息（注意：setFrom() 和 setSender() 作用不同）
$mail->setTo('<a class="__cf_email__" data-cf-email="176e78626557727a767e7b396f6f6f" href="/cdn-cgi/l/email-protection">[email protected]</a>');
$mail->setFrom('<a class="__cf_email__" data-cf-email="176e78626557727a767e7b396f6f6f" href="/cdn-cgi/l/email-protection">[email protected]</a>'); // 实际 From 邮箱头
$mail->setSender(html_entity_decode('Ioannou Stores', ENT_QUOTES, 'UTF-8')); // 显示名称（用于客户端显示）
$mail->setSubject(html_entity_decode('-5% Έκπτωση στο ioannoustores.com', ENT_QUOTES, 'UTF-8'));
$mail->setHtml(html_entity_decode($message, ENT_QUOTES, 'UTF-8')); // ✅ 必须使用 setHtml() 发送 HTML 内容
$mail->send();
⚠️ 关键注意事项：
- 避免硬编码邮箱： 是 Cloudflare 邮箱混淆标签，实际部署时需禁用 Cloudflare 邮箱保护，或在服务器端还原真实邮箱（如通过 data-cfemail 解码），否则 mail() 或 Mail 类均无法解析。
- 编码必须显式处理：希腊语等非 ASCII 内容务必用 html_entity_decode(..., ENT_QUOTES, 'UTF-8') 解码，否则邮件主题/正文将出现乱码。
- setFrom() ≠ setSender()：setFrom() 设置 SMTP MAIL FROM 地址（影响 SPF/DKIM 验证），setSender() 设置“发件人显示名”，二者均需合规。
- SMTP 配置优先级：若后台启用了 SMTP，config_mail_engine 应为 'smtp'，且 smtp_* 参数必须完整有效（含端口、认证、TLS 设置）；测试前请在后台「系统 → 设置 → 邮件」中确认配置已保存。
- 不要修改 footer.php 处理业务逻辑：控制器 catalog/controller/common/footer.php 仅用于渲染页脚，不应承担订阅邮件发送职责。建议将邮件逻辑移至专用控制器（如 catalog/controller/account/newsletter.php）或模型层，保持 MVC 分离。
? 补充调试技巧：
启用 OpenCart 日志记录，在 config.php 中添加 define('MAIL_DEBUG', true);，或临时捕获异常：
try {
$mail->send();
} catch (Exception $e) {
$this->log->write('Newsletter email failed: ' . $e->getMessage());
}
综上，迁移到 OpenCart 3.x 的邮件发送，核心是拥抱框架抽象层——放弃裸 mail()，善用 Mail 类 + 后台配置 + UTF-8 安全解码，方可稳定、可维护地实现批量营销邮件功能。
