PHP mail() 返回 false 表示未成功提交至本地MTA，需检查disable_functions、sendmail_path路径、mail.log权限、MTA服务状态、-f参数及SPF配置。
PHP mail() 函数返回 false 时，不等于“没发出去”，而是“连本地 MTA 都没交上去”——真正的问题往往藏在系统层或配置层，不是改几行 PHP 就能解决的。
检查 mail() 是否真被禁用或不可用
别只信 function_exists('mail') 返回 true，它只说明函数存在，不代表能用。很多主机（尤其 one.com、SiteGround 等共享环境）会保留函数声明但实际拦截调用。
- 运行
var_dump(ini_get('disable_functions'))，确认mail不在返回值里 - 执行
php -r "var_dump(mail('test@example.com','t','t'));"，在 CLI 下单独测试——Web 环境和 CLI 的 php.ini 可能不同 - 查
phpinfo()页面里的sendmail_path值是否为空或指向不存在路径（如/usr/sbin/sendmail但实际是/usr/bin/sendmail）
启用 mail.log 并确认日志写入权限
PHP 8.5.5+ 默认支持 mail.log，但它不会自动创建目录或设权限，静默失败很常见。
- 在
php.ini中设置mail.log = /var/log/php_mail.log（路径必须绝对、父目录需存在） - 确保 Web 进程用户（如
www-data或nginx）对该路径有write权限：sudo chown www-data:www-data /var/log/php_mail.log（若文件不存在，先 touch 再 chown） - 重启 PHP-FPM 或 Apache 后，执行一次
mail()调用，立刻tail -f /var/log/php_mail.log查看是否有记录——没输出=根本没走到 mail 层
验证 sendmail/postfix 是否真在运行且响应正常
mail() 是个“甩手掌柜”，只把数据交给本地 MTA；MTA 拒绝或挂掉，mail() 就直接返回 false，不报错。
立即学习“PHP免费学习笔记（深入）”；
- Linux 下执行
systemctl is-active sendmail或systemctl is-active postfix，状态不是active (running)就得先启动 - 手动模拟调用：
echo -e "To: test@example.com\nSubject: test\n\nbody" | /usr/sbin/sendmail -t -i，若卡住或报cannot connect to daemon，说明 MTA 没监听或被防火墙拦了 - 检查
/var/log/mail.log或/var/log/maillog，搜索stat=或reject关键词，常能看到具体拒因（如user unknown、no valid recipients）
用 -f 参数 + Return-Path 头捕获真实错误
多数共享主机要求明确发件人身份，否则直接丢弃；而错误信息只有通过 Return-Path 才能回传到你邮箱，mail() 自身不暴露这些。
- 构造
$additional_params：必须用-f webmaster@yourdomain.com，域名要和From:头一致，否则 SPF 失败 - 在
$headers中显式加Return-Path: webmaster@yourdomain.com\r\n，双重保险 - 测试时把
$to设成你自己邮箱，等几分钟——如果邮件没到，但你收到了一封主题为Returned mail的退信，里面就含原始错误（如550 5.7.1 Client host rejected）
真正卡点不在 PHP 代码里，而在 sendmail_path 对不对、MTA 日志有没有权限读、-f 域名有没有配 SPF 记录——这些地方漏一个，mail() 就永远静默返回 false。
