XAMPP启用Sendmail:在本地测试PHP mail()函数发送邮件功能

浅杰小哥_6474

浅杰小哥_6474

2026-06-11

310人浏览

原创

xampp 的 mail() 默认无法发邮件,因其依赖系统 sendmail 而 windows 无原生支持;需配置 xampp 自带 sendmail.exe 指向真实 smtp(如 gmail),并修改 php.ini 中 sendmail_path,启用两步验证及应用专用密码,或改用 phpmailer 直连 smtp 提升可靠性与可调试性。

xampp启用sendmail:在本地测试php mail()函数发送邮件功能

为什么 mail() 在 XAMPP 里默认发不出邮件?

因为 XAMPP 自带的 mail() 函数不连接任何 SMTP 服务器,它依赖系统级的 sendmail 命令(Windows 下并不存在),而 Windows 没有原生 sendmail 可执行文件。直接调用 mail() 会静默失败或报错 Warning: mail(): Failed to connect to mailserver。

解决路径只有一条:让 XAMPP 的 PHP 通过本地代理(即 sendmail.exe)把邮件转给真实 SMTP(如 Gmail、Outlook 或企业邮箱)。

如何配置 XAMPP 的 sendmail.exe 并关联 PHP?

XAMPP 自带一个精简版 sendmail.exe(位于 \xampp\sendmail\),但它默认未启用,且配置文件 sendmail.ini 是空的或指向无效地址。

  • 编辑 \xampp\sendmail\sendmail.ini,填入可用 SMTP 账号(以 Gmail 为例):
[sendmail]
smtp_server=smtp.gmail.com
smtp_port=587
auth_username=your.email@gmail.com
auth_password=your_app_password
force_sender=your.email@gmail.com
tls=yes

注意:auth_password 必须是 Google 账号开启两步验证后生成的「应用专用密码」,不是登录密码;tls=yes 不可写成 ssl=yes,否则连接失败。

  • 编辑 \xampp\php\php.ini,找到 [mail function] 区块,修改为:
SMTP=127.0.0.1
smtp_port=25
sendmail_path="\"C:\xampp\sendmail\sendmail.exe\" -t"

其中 sendmail_path 的路径必须用双引号包裹,且结尾带 -t 参数(让 sendmail 从邮件头读取收件人,而非命令行传参)。

改完重启 Apache。

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理:站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

测试 mail() 时为什么收不到邮件?常见卡点

即使配置全对,仍可能失败,原因往往藏在细节里:

  • Gmail 账号未开启「允许不够安全的应用」——现在已弃用,必须用「应用专用密码」+ 开启两步验证
  • sendmail.exe 被杀毒软件拦截(尤其 Windows Defender 实时防护),临时禁用或添加信任后重试
  • PHP 脚本中 mail() 第三个参数(headers)缺失 From:,导致 sendmail.exe 拒绝投递(Gmail 强制要求发件人匹配 force_sender)
  • 测试代码没加错误检查,实际失败了却看不到提示:
$ok = mail('test@example.com', 'subject', 'body', "From: your.email@gmail.com");
if (!$ok) echo "mail() returned false";

返回 false 表示 PHP 层调用失败(如配置路径错、sendmail.exe 权限不足);返回 true 只代表“交给 sendmail 了”,不代表邮件真发出去了——查 \xampp\sendmail\sendmail.log 才能确认 SMTP 连接与认证是否成功。

替代方案:不用 sendmail.exe,直接用 PHPMailer 更可靠

sendmail.exe 是黑盒,出问题难调试;而 PHPMailer 直连 SMTP,报错明确,支持 OAuth2、附件、HTML 邮件等,本地开发更省心。

只需几行代码:

use PHPMailer\PHPMailer\PHPMailer;
$mail = new PHPMailer(true);
$mail->isSMTP();
$mail->Host = 'smtp.gmail.com';
$mail->Port = 587;
$mail->SMTPAuth = true;
$mail->Username = 'your.email@gmail.com';
$mail->Password = 'your_app_password';
$mail->setFrom('your.email@gmail.com');
$mail->addAddress('test@example.com');
$mail->Subject = 'Test';
$mail->Body = 'Hello';
$mail->send();

相比 sendmail 配置,PHPMailer 把所有关键参数显式暴露出来,网络不通、密码错、端口封、TLS 不匹配……错误信息直接抛出异常,一眼定位。

真正麻烦的从来不是“怎么配”,而是配完之后日志不输出、失败无反馈、SMTP 认证被静默拒绝——这些地方最容易花掉半天时间反复试错。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

xampp php

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

10744

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

6281

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2135

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

3968

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

4674

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3671

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

5237

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

4102

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

12042

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程