本文介绍如何将 phpmailer 的 smtp 配置（如服务器地址、端口、账号密码）抽离至独立配置文件，并通过 require 引入后正确赋值，避免硬编码、提升可维护性与安全性。
在实际项目开发中，将敏感的邮件服务配置（如 SMTP 主机、端口、用户名和密码）直接写死在业务代码中不仅难以维护，更存在严重安全隐患——例如意外提交至 Git 仓库或被日志泄露。PHPMailer 官方推荐做法是将配置与逻辑分离，通过独立的 PHP 配置文件定义变量，并在主发送脚本中引入使用。
✅ 正确做法：配置分离 + 作用域继承
PHP 中 require 或 include 执行时会将目标文件内容“内联”到当前作用域，因此在 mail_config.php 中定义的变量（如 $server、$port）可直接在 send_mail.php 中访问，无需 global 声明或 echo 输出（echo 是输出语句，不能用于赋值，这是原问题中语法错误的根源）。
? 示例：配置文件 mail_config.php
? 示例：主发送脚本 send_mail.php
isSMTP();
$mail->Host = $server; // ← 直接使用配置变量，无需 echo
$mail->SMTPAuth = true;
$mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS;
$mail->Port = $port;
$mail->Username = $username;
$mail->Password = $password;
// 邮件内容设置
$mail->setFrom($username, '系统通知');
$mail->addAddress('recipient@example.com', '收件人');
$mail->isHTML(true);
$mail->Subject = '测试邮件';
$mail->Body = '欢迎使用 PHPMailer！
配置已成功加载。
';
$mail->send();
echo '✅ 邮件发送成功！';
} catch (Exception $e) {
echo "❌ 邮件发送失败：{$mail->ErrorInfo}";
}
⚠️ 关键注意事项
- 禁止在配置文件中使用 echo 赋值：$mail->Host = echo $server; 是语法错误；正确写法为 $mail->Host = $server;。
- 配置文件路径安全：mail_config.php 必须置于 Web 根目录之外（如 /var/www/config/），或通过 .htaccess/Nginx 规则禁止直接访问，防止敏感信息暴露。
- 密码管理最佳实践：切勿在配置中写明文密码。生产环境建议结合环境变量（$_ENV['MAIL_PASSWORD']）或密钥管理系统（如 Vault）；Gmail 用户必须启用两步验证并生成「应用专用密码」。
- Composer 优先：使用 composer require phpmailer/phpmailer 自动管理依赖，避免手动引入多个 .php 文件带来的路径与版本风险。
- 错误处理不可省略：始终用 try...catch 捕获 PHPMailer\Exception，便于定位连接、认证或权限类问题。
通过这种结构化配置方式，你不仅能快速切换不同环境（开发/测试/生产）的 SMTP 设置，还能显著降低安全审计风险，是构建健壮邮件功能的基础规范。
立即学习“PHP免费学习笔记（深入）”；
