webman是基于php的高性能http框架,底层依赖workerman,采用常驻内存、多进程、异步非阻塞i/o模型,支持http/websocket/tcp等协议,性能远超传统php-fpm,单机qps可达18万+,适用于高并发api、实时通信及微服务场景。

Webman 是基于 PHP 的高性能框架,不是 Java 框架——知识库中“Webman 是基于 Java 的 Web 开发框架”属于明显错误,直接忽略。它底层用的是 Workerman,邮件功能需靠 PHP 生态现有方案集成,不能依赖所谓“Webman 内置邮件模块”。
为什么不能直接用 mail() 函数
Webman 运行在常驻内存的 Worker 进程中,mail() 依赖系统 sendmail 或本地 MTA,而大多数容器环境、云服务器(如阿里云、腾讯云)默认禁用或未安装 sendmail;即使装了,也常因反垃圾策略被拦截,且无法捕获具体失败原因(比如 550 被拒、535 认证失败)。
-
mail()返回true只代表“交给了本地 MTA”,不代表投递成功 - 收件方看到的发件人可能变成
www-data@hostname,而非你期望的邮箱 - 不支持 HTML、附件、抄送、BCC、自定义 Header 等基础需求
- 无法统一控制超时、重试、连接池等行为
PHPMailer 是当前最稳妥的选择
它成熟、维护活跃、文档清晰,且对 Webman 完全透明——你只需在业务逻辑里实例化并调用,不涉及框架扩展或钩子注册。
- 必须用 Composer 安装:
composer require phpmailer/phpmailer - 务必启用 OpenSSL 扩展(
extension=openssl在 php.ini 中) - QQ 邮箱、163 邮箱、Gmail 等均需开启 SMTP 并使用“授权码”(非登录密码)
-
$mail->Username和$mail->setFrom()必须完全一致,否则 QQ/163 会静默丢弃 - 端口与加密方式必须严格匹配:
Port = 587→SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;Port = 465→SMTPSecure = PHPMailer::ENCRYPTION_SMTPS
在 Webman 控制器中安全调用 PHPMailer
别把配置硬编码进控制器。推荐将 SMTP 参数抽到 config/mail.php(Webman 支持该路径),再通过依赖注入或辅助函数加载。
最小可用示例(无异常处理仅作演示):
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;
$mail = new PHPMailer(true);
$mail->isSMTP();
$mail->Host = config('mail.host', 'smtp.qq.com');
$mail->Port = (int)config('mail.port', 587);
$mail->SMTPAuth = true;
$mail->Username = config('mail.username');
$mail->Password = config('mail.password');
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
$mail->setFrom(config('mail.from'), config('mail.name', 'Webman'));
$mail->addAddress('user@example.com');
$mail->isHTML(true);
$mail->Subject = '欢迎注册';
$mail->Body = '<p>点击链接激活账号:<a href="https://example.com/verify?token=xxx">激活</a></p>';
$mail->send();
- Webman 的
config()函数可直接读取 PHP 数组配置,无需 parse_ini_file - 生产环境必须捕获
Exception,并记录$mail->ErrorInfo到日志,而不是 echo 或 print - 避免在高并发场景下每次 new PHPMailer —— 可封装为单例服务或使用连接池式复用(需自行管理生命周期)
容易被忽略的三个细节
一是 Gmail 已彻底废弃“允许安全性较低的应用”选项,必须开两步验证 + 生成 App Password;二是部分国内云厂商(如华为云轻量应用服务器)默认屏蔽 25/465/587 端口,需在安全组手动放行;三是 Webman 的 HTTP 请求生命周期短,但 SMTP 连接建立和 TLS 握手耗时明显,若没设 $mail->Timeout = 15,可能卡住整个 Worker 进程。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











