PHP mail()失败需依次检查：一、确认mail未被php.ini的disable_functions禁用；二、Linux/macOS配置正确的sendmail_path路径及参数；三、Windows需安装第三方sendmail工具并配置SMTP；四、确保From头合法且换行符为\r\n；五、用最小化脚本验证链路。
如果您在PHP中调用mail()函数但邮件始终未送达，且服务器日志显示“unable to execute sendmail”或“failed to open stream”，则可能是由于系统邮件服务未启用、sendmail_path配置错误或权限限制导致。以下是PHP调用系统邮件服务的具体配置指南：
一、确认mail()函数未被禁用
PHP内置mail()函数是核心组件，但可能被php.ini中的disable_functions指令显式禁用，导致函数调用直接失败。
1、定位当前生效的php.ini文件：在Web环境中运行，查找“Loaded Configuration File”路径。
2、使用文本编辑器打开该php.ini文件，搜索disable_functions指令行。
立即学习“PHP免费学习笔记（深入）”；
3、检查mail是否出现在该指令值中，例如disable_functions = exec,passthru,shell_exec,mail。
4、若存在，将mail从列表中删除，确保其不处于禁用状态。
5、保存文件后，重启Web服务器（如Apache执行sudo systemctl restart apache2，Nginx搭配PHP-FPM则执行sudo systemctl restart php-fpm）。
二、Linux/macOS下配置sendmail_path
PHP通过sendmail_path调用本地MTA（如sendmail、postfix或msmtp）投递邮件，路径错误或参数缺失将导致命令执行失败或邮件被丢弃。
1、确认系统已安装并运行MTA：执行which sendmail或which postfix，若返回空则需安装，例如Ubuntu执行sudo apt install sendmail-bin。
2、验证MTA可正常发送测试邮件：运行echo "Test" | sendmail -v user@example.com，观察终端输出是否含“sent”字样。
3、在php.ini中找到sendmail_path配置项，取消其注释（删除行首分号）。
4、将其设置为完整可执行路径加标准参数，例如：sendmail_path = "/usr/sbin/sendmail -t -i"；其中-t表示读取收件人头，-i忽略单点行终止符。
5、保存php.ini并重启Web服务，使新路径生效。
三、Windows下模拟sendmail环境
Windows原生不提供sendmail命令，PHP默认无法调用，需借助第三方轻量级sendmail封装工具实现兼容。
1、下载glob.com.au提供的sendmail.zip压缩包，并解压至简单路径，例如C:\wamp\sendmail（避免中文与空格）。
2、编辑php.ini，在[mail function]节下修改sendmail_path为：sendmail_path = "C:\wamp\sendmail\sendmail.exe -t"。
3、打开解压目录下的sendmail.ini，配置SMTP服务器信息：将smtp_server改为实际邮箱服务商地址（如smtp.qq.com），smtp_port设为587（支持TLS）或465（SSL）。
4、在sendmail.ini中设置账户凭据：填写auth_username（如user@qq.com）与auth_password（必须为应用专用密码，非登录密码）。
5、保存全部配置文件，重启WAMP/XAMPP服务套件。
四、验证From头与邮件头部格式
多数MTA（尤其是postfix和现代云邮箱）强制要求合法From头，缺失或格式错误（如换行符为\n而非\r\n）将导致静默丢弃。
1、在调用mail()时，headers参数必须包含From字段，例如："From: admin@domain.com\r\nReply-To: admin@domain.com\r\n"。
2、确保所有头部字段以\r\n结尾，不可混用\n；多字段间也必须用\r\n分隔。
3、避免subject参数中出现换行符，否则函数调用将立即返回false。
4、对message正文使用wordwrap()限制每行≤70字符，并统一用\n换行；PHP内部会自动处理行末转换。
五、执行最小化测试脚本验证链路
排除代码逻辑干扰，使用无依赖、仅含必要参数的脚本直接测试底层链路是否贯通。
1、创建test_mail.php文件，写入以下内容：
<?php
$to = 'your_email@example.com';
$subject = 'PHP mail test';
$message = "This is a system mail test.\nTime: " . date('Y-m-d H:i:s');
$headers = "From: test@localhost\r\n";
$result = mail($to, $subject, $message, $headers);
var_dump($result);
?>
2、通过CLI方式运行：php test_mail.php，观察输出是否为bool(true)。
3、若CLI返回true但Web访问不生效，检查Web服务器用户（如www-data）对sendmail路径是否有执行权限。
4、若CLI亦返回false，检查系统日志：Linux执行sudo tail -f /var/log/mail.log，Windows查看sendmail.exe所在目录的error.log。
