php 8.2 必须使用 phpmailer 等第三方库实现 smtp 邮件发送，因其已弃用 mail() 函数的系统 mta 依赖和 php.ini smtp 配置，且强制要求显式指定 encryption_starttls 或 encryption_smtps 常量、端口及授权码。
PHP 8.2 本身不内置 SMTP 客户端能力，mail() 函数仍依赖系统 MTA 或 Windows 的 SMTP 配置项，但这些方式在现代环境（尤其是云服务器、Docker、本地开发）下基本不可靠。直接改 php.ini 的 SMTP 和 smtp_port 只对 Windows 旧版 IIS/CGI 有效，且不支持认证和加密——PHP 8.2 已彻底弃用该路径的生产可用性。
PHP 8.2 必须用 PHPMailer（或类似库）走 SMTP
PHP 8.2 移除了对 php_smtp.dll 等非标准扩展的支持，mail() 在无本地 MTA 的容器或 WSL 环境中默认失败。唯一稳定路径是引入带完整 TLS/SSL、AUTH、错误反馈的第三方 SMTP 封装库。
-
composer require phpmailer/phpmailer（推荐，自动处理 autoloading 和版本兼容） - 若不能用 Composer，下载
PHPMailer/src/全部文件到项目目录，手动require主类 - 确认
extension=openssl在php.ini中已启用（PHP 8.2 默认开启，但 Docker 镜像可能关闭） - 不要尝试用
ini_set('SMTP', ...)动态覆盖——PHP 8.2 不允许运行时修改 SMTP 相关 INI 设置
PHPMailer 配置必须显式指定加密方式和端口
PHP 8.2 + PHPMailer 6.9+ 强制要求明确区分 ENCRYPTION_SMTPS（SSL，端口 465）和 ENCRYPTION_STARTTLS（TLS，端口 587）。填错会静默失败或抛出 SMTP connect() failed。
- QQ 邮箱：用
$mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS;+$mail->Port = 465; - Gmail / Outlook / 企业邮箱：用
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;+$mail->Port = 587; - 绝对不要写
$mail->SMTPSecure = 'tls'或'ssl'字符串——PHPMailer 6.8+ 已废弃字符串模式，只认常量 - 密码字段必须填「授权码」，不是邮箱登录密码；QQ/163/Outlook 均需在邮箱设置页单独开通 SMTP 并生成
常见失败现象与对应检查点
运行后报 SMTP Error: Could not authenticate 或 Connection timed out，不是代码写错了，而是环境或配置卡点：
- 防火墙/云厂商安全组是否放行目标端口（465/587）？很多阿里云/腾讯云 ECS 默认屏蔽 25/465/587
- Docker 容器内没开 DNS：加
--dns 8.8.8.8或在docker-compose.yml中配dns字段 - 使用
localhost或127.0.0.1作为$mail->Host—— 这是本地回环，不是你的 SMTP 服务器地址 - PHP 8.2 的
allow_url_fopen关闭不影响 PHPMailer，但某些调试用的远程日志上报会失效，别误判为邮件问题
最易被忽略的是：PHP 8.2 的 error_reporting 默认不显示 E_WARNING 级别错误，而 PHPMailer 的底层 socket 连接失败常以 warning 形式抛出。务必在脚本开头加 error_reporting(E_ALL); ini_set('display_errors', '1');，否则你看到的只是空白页面或 “邮件发送失败” 而无具体原因。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
