在本地PHP开发过程中，经常需要验证注册邮件、找回密码或系统通知的发送逻辑。借助phpEnv自带的SMTP调试能力，开发者可以在不连接外网邮箱的情况下，完成邮件代码的全部链路测试。下面介绍具体的配置与使用方式。
一、phpEnv中开启本地SMTP代理
phpEnv在Windows环境下集成了多个网站运行所需的组件，其中就包含用于捕获邮件的本地SMTP服务。默认该服务可能不会随主面板启动，需要手动在“扩展工具”或“邮件调试”标签页中点击开启。开启后，程序会在本机监听25端口，并模拟成一个可用的SMTP服务器。
这种做法的本质是反向代理加内容落盘：所有指向localhost:25的邮件会话都会被接收，但并不会真正投递到收件人邮箱，而是将邮件原文写入phpEnv目录下的邮件日志文件夹。开发者之后在面板里就能直接看到发件人、收件人、主题和正文，对调试HTML邮件模板尤其方便。
二、调整PHP邮件相关配置
如果使用PHP内置的mail()函数，需要确认php.ini中的SMTP与smtp_port指向本地代理。在phpEnv对应的PHP版本设置中打开配置文件，修改如下内容：
[mail function] ; 仅Windows下有效，指定本地SMTP代理地址 SMTP = localhost smtp_port = 25 ; 发件人地址，可随意填写用于测试 sendmail_from = test@ipipp.com
上述配置告知PHP引擎，所有mail()调用都应通过localhost的25端口提交。注意若本机已安装其他邮件服务器占用了25端口，需先停止冲突程序，或把phpEnv的SMTP代理改为1025等高位端口，并同步修改smtp_port。
对于使用SwiftMailer、PHPMailer等库的项目，则应在代码中将Host设为localhost、Port设为25，并关闭TLS加密，因为本地代理不支持安全连接。这样既能复用框架的邮件封装，又能把信件截留在本地。
三、原生mail函数发送测试
写一段最简单的脚本验证环境是否生效。下面的例子演示了如何发送纯文本邮件：
<?php
$to = 'user@ipipp.com';
$subject = '本地SMTP测试';
$message = '这是一封通过phpEnv本地代理发出的测试邮件';
$headers = 'From: test@ipipp.com' . "rn" .
'Content-Type: text/plain; charset=utf-8';
if (mail($to, $subject, $message, $headers)) {
echo '邮件已提交到本地SMTP代理';
} else {
echo '发送失败，请检查php.ini与代理状态';
}
?>
运行后前往phpEnv的邮件日志界面，应当能看到主题为“本地SMTP测试”的信件。若页面空白或报false，多半是SMTP服务未启动，或PHP进程读取了错误的ini文件。可在脚本中调用phpinfo()确认Loaded Configuration File路径。
原生函数适合轻量验证，但在真实项目中往往难以处理附件与HTML排版。因此更推荐用成熟库来写邮件体，同时仍走本地代理。
四、ThinkPHP结合本地SMTP发信
以ThinkPHP为例，在config/mail.php中配置transport为smtp，并指向本地代理：
<?php
return [
'default' => 'smtp',
'mailers' => [
'smtp' => [
'transport' => 'smtp',
'host' => 'localhost',
'port' => 25,
'encryption' => null,
'username' => null,
'password' => null,
'from' => ['test@ipipp.com' => '本地测试'],
],
],
];
?>
随后使用框架封装的邮件门面发送模板邮件：
<?php
use thinkfacadeMail;
Mail::html('<h3>验证码</h3><p>您的码是123456</p>')
->to('user@ipipp.com')
->subject('账户安全验证')
->send();
?>
这种写法完全贴近生产代码，唯一的区别是host与port指向了本地。团队在编写完通知模块后，不必等待运维开通企业邮箱即可自测页面渲染与字段替换是否正确。待上线时仅改配置即可切到真实服务商。
五、常见问题与端口冲突处理
部分Windows系统自带或后装的杀毒软件会占用25端口做邮件扫描，导致phpEnv代理启动失败。此时可在phpEnv设置中将代理端口改为1025，并统一修改php.ini及框架配置中的smtp_port为1025。
| 现象 | 可能原因 | 解决办法 |
|---|---|---|
| mail返回false | SMTP代理未运行 | 在面板启动邮件调试 |
| 连接被拒绝 | 端口被占用 | 更换为1025等端口 |
| 中文乱码 | 未声明charset | headers加utf-8 |
另外，某些框架默认要求加密连接，若未关闭encryption，本地代理会直接断开。明确将encryption置为null或空字符串，是避免握手失败的关键。
六、本地与真实邮箱方案对比
使用外部邮箱如ipipp.com企业邮，优势在于能验证送达率与反垃圾策略，但注册、授权码、日限额都增加调试成本。本地SMTP代理则专注开发期，不依赖网络，内容全留痕，缺点是无法确认真实投递效果。
- 本地代理：零外网依赖，适合功能自测与模板检查
- 真实SMTP：可测送达与拦截，适合预发布环境
建议开发阶段用phpEnv本地环境反复验证邮件结构与变量注入，部署前再切换到真实服务做一次连通性确认，这样效率与可靠性可兼得。