本文介绍如何将 phpmailer 的 smtp 配置（如服务器地址、端口、账号密码）抽离至独立配置文件，并通过 require 引入后正确赋值，避免硬编码、提升可维护性与安全性。
在实际项目开发中，将敏感的邮件服务配置（如 SMTP 主机、端口、用户名和密码）直接写死在业务代码中不仅难以维护，更存在严重安全隐患——例如意外提交至 Git 仓库或被日志泄露。PHPMailer 官方推荐做法是将配置与逻辑分离，通过独立的 PHP 配置文件定义变量，并在主发送脚本中引入使用。
✅ 正确做法：配置分离 + 作用域继承
PHP 中 require 或 include 执行时会将目标文件内容“内联”到当前作用域，因此在 mail_config.php 中定义的变量（如 $server、$port）可直接在 send_mail.php 中访问，无需 global 声明或 echo 输出（echo 是输出语句，不能用于赋值，这是原问题中语法错误的根源）。
? 示例：配置文件 mail_config.php
<?php // mail_config.php —— 请确保该文件不在 Web 可访问目录下（如放在 /config/ 或项目根目录外） $server = 'smtp.gmail.com'; $port = 465; $username = 'your-verified@gmail.com'; $password = 'your-app-specific-password'; // ⚠️ 使用 Gmail 应用专用密码，非账户密码 ?>
? 示例：主发送脚本 send_mail.php
<?php
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;
// 1. 加载配置（变量在此处生效）
require __DIR__ . '/mail_config.php';
// 2. 加载 PHPMailer 类（推荐使用 Composer）
require __DIR__ . '/vendor/autoload.php';
// 3. 初始化并配置
$mail = new PHPMailer(true);
try {
$mail->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 = '<h2>欢迎使用 PHPMailer！</h2><p>配置已成功加载。</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/ai/2240" title="Boba.video"><img
src="https://img.php.cn/upload/ai_manual/000/000/000/175680315157357.png" alt="Boba.video" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/ai/2240" title="Boba.video">Boba.video</a>
<p>AI动漫视频生成器</p>
</div>
<a href="/ai/2240" title="Boba.video" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>';
$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免费学习笔记（深入）”；
