PHP邮件功能配置需依次完成：一、启用mail()函数并确保未被禁用；二、Linux/macOS下配置sendmail_path指向正确路径；三、推荐使用PHPMailer支持SMTP认证与TLS；四、Windows旧版可配SMTP参数但不安全；五、通过测试脚本验证返回值与异常。
如果您在PHP环境中需要实现邮件发送功能，但无法正常发送邮件，则可能是由于邮件配置未正确设置或相关扩展未启用。以下是完成PHP邮件功能配置的具体操作步骤：
一、启用PHP mail()函数
PHP内置的mail()函数依赖于服务器本地的邮件传输代理（MTA），如sendmail（Linux）或SMTP服务（Windows）。需确保PHP配置中未禁用该函数，并确认系统级邮件服务可用。
1、打开php.ini文件，查找disable_functions指令。
2、确认mail未出现在该指令的值列表中，例如：disable_functions = exec,passthru,shell_exec（不含mail）。
立即学习“PHP免费学习笔记（深入）”；
3、若已禁用，将其从列表中移除，保存文件。
4、重启Web服务器（如Apache或Nginx）使配置生效。
二、配置sendmail_path（Linux/macOS）
在类Unix系统中，PHP通过sendmail_path调用本地sendmail兼容程序（如sendmail、postfix或msmtp）来投递邮件。必须确保路径指向可执行且配置正确的二进制文件。
1、确认系统已安装sendmail或postfix，例如运行which sendmail获取路径。
2、在php.ini中找到sendmail_path选项。
3、将其设置为实际路径并添加必要参数，例如：sendmail_path = "/usr/sbin/sendmail -t -i"。
4、保存php.ini并重启Web服务。
三、使用PHPMailer库替代原生mail()
原生mail()函数缺乏SMTP认证、SSL/TLS支持及错误反馈机制，PHPMailer提供更稳定、可调试的邮件发送能力，适用于Gmail、Outlook、腾讯企业邮箱等主流服务商。
1、通过Composer安装PHPMailer：composer require phpmailer/phpmailer。
2、在PHP脚本中引入自动加载器：require 'vendor/autoload.php';。
3、实例化PHPMailer对象并启用SMTP：$mail = new PHPMailer\PHPMailer\PHPMailer(true);。
4、设置SMTP主机、端口、用户名与密码，例如：$mail->Host = 'smtp.qq.com'; $mail->Port = 587;。
四、配置Windows下的SMTP扩展（仅限旧版PHP）
在Windows环境下，部分旧版本PHP依赖php_smtp.dll扩展（非官方核心扩展），现普遍推荐改用PHPMailer；若必须使用原生方式，需手动配置SMTP参数。
1、在php.ini中取消注释extension=php_sockets.dll（确保sockets支持启用）。
2、添加以下配置段：[mail function] SMTP = smtp.gmail.com smtp_port = 587 sendmail_from = your@gmail.com。
3、注意：此方式不支持密码认证，仅适用于允许匿名中继的内部SMTP服务器，**生产环境严禁使用**。
五、验证邮件配置是否生效
通过最小化测试脚本检查mail()函数或PHPMailer是否能成功触发邮件发送流程，重点观察返回值与异常信息，而非最终收件箱是否收到。
1、创建test_mail.php文件，写入基础mail()调用：var_dump(mail('test@example.com', 'Test', 'Body')); 。
2、执行该脚本：php test_mail.php，返回true仅表示投递请求发出，不代表送达。
3、若使用PHPMailer，捕获异常：try { $mail->send(); } catch (Exception $e) { echo "Error: " . $mail->ErrorInfo; }。
