huyuanxiang
/
official-website-abroad
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'd46195d9f4'
${ noResults }
official-website-abroad/wp-content/themes/nenghui-energy-theme-4/inc/smtp/README.md

8.9 KiB
Raw Blame History Escape

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

SMTP邮件配置系统

这是一个为WordPress主题开发的SMTP邮件配置系统，提供完整的邮件发送功能。

功能特性

1. SMTP邮件配置

  • 支持主流邮件服务商（Gmail、QQ邮箱、163邮箱、阿里云邮箱等）
  • 灵活的加密方式配置（TLS/SSL/无加密）
  • 系统诊断工具：检查服务器环境和PHP扩展支持
  • 连接测试功能：验证SMTP服务器连接状态
  • 测试邮件发送功能
  • 详细的错误提示和调试信息

2. 安全特性

  • 配置验证和错误提示
  • 数据清理和验证
  • 安全的密码存储

文件结构

inc/smtp/
├── smtp-config.php      # SMTP核心配置文件
├── smtp-admin.php       # 后台管理页面
├── smtp-diagnostic.php  # SMTP诊断工具
└── README.md           # 使用说明文档

配置步骤

1. 访问SMTP设置页面

  1. 登录WordPress后台
  2. 进入 设置 → SMTP邮件设置
  3. 配置相关参数

2. SMTP服务器设置

  • SMTP主机：邮件服务商的SMTP服务器地址
  • SMTP端口：通常为587（TLS）或465（SSL）
  • 加密方式：推荐使用TLS或SSL
  • SMTP用户名：通常是您的邮箱地址
  • SMTP密码：邮箱密码或应用专用密码
  • 发件人邮箱：邮件的发件人地址
  • 发件人姓名：邮件的发件人显示名称

3. 常用邮件服务商配置

Gmail配置

SMTP主机: smtp.gmail.com
SMTP端口: 587
加密方式: TLS
用户名: your-email@gmail.com
密码: 应用专用密码（需开启两步验证）

QQ邮箱配置

SMTP主机: smtp.qq.com
SMTP端口: 587 或 465
加密方式: TLS 或 SSL
用户名: your-email@qq.com
密码: 授权码（需在QQ邮箱设置中获取）

163邮箱配置

SMTP主机: smtp.163.com
SMTP端口: 587 或 465
加密方式: TLS 或 SSL
用户名: your-email@163.com
密码: 授权码（需在163邮箱设置中获取）

阿里云邮箱配置

SMTP主机: smtp.mxhichina.com
SMTP端口: 587 或 465
加密方式: TLS 或 SSL
用户名: your-email@yourdomain.com
密码: 授权码（必须使用授权码，不能使用登录密码）

hMailServer 自建邮箱配置

SMTP主机: 您的邮件服务器域名或IP地址
SMTP端口: 25 (无加密) / 587 (TLS) / 465 (SSL)
加密方式: None / TLS / SSL（根据服务器配置选择）
用户名: 完整邮箱地址或用户名（取决于hMailServer配置）
密码: 邮箱账户密码

hMailServer 配置注意事项：

  • 确保hMailServer服务已启动并正常运行
  • 检查SMTP服务是否已在hMailServer中启用
  • 确认防火墙允许相应端口的连接
  • 如果使用域名，确保DNS解析正确
  • 建议使用TLS加密（端口587）以提高安全性

3. 测试SMTP连接

配置完成后，点击 发送测试邮件 按钮验证配置是否正确。

系统会发送一封测试邮件到管理员邮箱，如果配置正确，您将收到测试邮件。如果发送失败，系统会显示详细的错误信息帮助您排查问题。

使用说明

系统诊断

在SMTP设置页面点击"系统诊断"按钮，系统会检查：

  • PHP版本和必要扩展
  • OpenSSL支持情况
  • 网络连接能力
  • SSL/TLS证书信息

测试SMTP连接

点击"测试连接"按钮，系统会尝试连接到SMTP服务器，验证：

  • 服务器地址和端口是否可达
  • SSL/TLS加密是否正常
  • 连接响应时间

发送测试邮件

点击"发送测试邮件"按钮，系统会向管理员邮箱发送一封测试邮件。如果配置正确，您将收到测试邮件。

在代码中发送邮件

配置完SMTP后，您可以在WordPress中正常使用 wp_mail() 函数发送邮件：

<?php
// 发送邮件示例
$to = 'recipient@example.com';
$subject = '邮件主题';
$message = '邮件内容';
$headers = array('Content-Type: text/html; charset=UTF-8');

$sent = wp_mail($to, $subject, $message, $headers);

if ($sent) {
    echo '邮件发送成功';
} else {
    echo '邮件发送失败';
}
?>

安全特性

  • 配置验证：系统会验证SMTP配置的完整性
  • 数据清理：所有配置数据都经过WordPress安全函数处理
  • 密码保护：SMTP密码安全存储在WordPress数据库中

故障排除

推荐的诊断步骤

遇到SMTP问题时，建议按以下顺序进行诊断：

  1. 运行系统诊断

    • 点击"系统诊断"按钮
    • 检查PHP版本和扩展支持
    • 确认OpenSSL和网络功能正常

  2. 测试服务器连接

    • 点击"测试连接"按钮
    • 验证能否连接到SMTP服务器
    • 检查SSL/TLS握手是否成功

  3. 发送测试邮件

    • 在连接测试成功后，点击"发送测试邮件"
    • 查看详细的错误信息和调试输出

常见问题解决方案

连接超时或拒绝连接

  • 检查SMTP服务器地址和端口
  • 确认服务器防火墙设置
  • 验证网络连接是否正常

SSL/TLS握手失败

  • 确认加密方式设置正确（TLS/SSL）
  • 检查OpenSSL版本和支持的协议
  • 尝试不同的端口（587用于TLS，465用于SSL）

认证失败 (526 Authentication failure)

⚠️ 重要：大多数邮箱服务需要使用授权码而不是登录密码！

阿里云邮箱：

  • 必须使用授权码，不能使用登录密码
  • 获取方式：登录阿里云邮箱 → 设置 → 账户安全 → 生成授权码
  • 用户名：完整邮箱地址

QQ邮箱：

  • 需要开启SMTP服务并使用授权码
  • 获取方式：QQ邮箱设置 → 账户 → POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务
  • 生成授权码后使用授权码作为密码

163邮箱：

  • 需要开启客户端授权密码
  • 获取方式：163邮箱设置 → POP3/SMTP/IMAP → 开启服务并获取授权码

Gmail：

  • 需要开启两步验证并使用应用专用密码
  • 获取方式：Google账户设置 → 安全性 → 应用专用密码

通用检查项：

  • 确认用户名格式正确（通常是完整邮箱地址）
  • 检查是否已在邮箱设置中开启SMTP服务
  • 验证授权码/应用密码是否正确输入

邮件发送失败但连接正常

  • 检查发件人邮箱设置
  • 确认邮箱配额未超限
  • 验证收件人邮箱地址有效性

hMailServer 自建邮箱常见问题

连接问题：

  • 确认hMailServer服务状态：检查Windows服务中的hMailServer是否正在运行
  • 验证SMTP服务启用：在hMailServer管理器中确认SMTP已启用
  • 检查端口配置：确认hMailServer中配置的SMTP端口与WordPress设置一致
  • 防火墙设置：确保Windows防火墙允许SMTP端口通信

认证问题：

  • 用户名格式：可能需要使用完整邮箱地址或仅用户名部分
  • 域名配置：确认邮箱域名在hMailServer中已正确配置
  • 账户状态：检查邮箱账户是否已启用且未被锁定

SSL/TLS问题：

  • 证书配置：如使用SSL/TLS，确保hMailServer中已正确配置SSL证书
  • 端口匹配：SSL通常使用465端口，TLS使用587端口
  • 加密设置：确认hMailServer的加密设置与WordPress配置匹配

网络问题：

  • DNS解析：如使用域名，确保DNS解析正确指向邮件服务器
  • 网络连通性：测试从WordPress服务器到hMailServer的网络连接
  • 路由配置：检查网络路由是否正确配置

常见问题

1. 邮件发送失败

  • 检查SMTP配置是否正确
  • 确认邮箱密码或授权码是否有效
  • 检查服务器是否允许SMTP连接
  • 查看WordPress调试日志
  • 确认防火墙没有阻止SMTP端口
  • 验证邮件服务商是否支持SMTP发送

调试模式

在wp-config.php中启用调试模式：

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

然后查看/wp-content/debug.log文件获取详细错误信息。

更新日志

v1.1.2

  • 新增hMailServer自建邮箱SMTP配置支持
  • 添加hMailServer配置说明和注意事项
  • 完善hMailServer常见问题的故障排除指南
  • 包含连接、认证、SSL/TLS和网络问题的解决方案

v1.1.1

  • 修复open_basedir限制导致的错误日志写入问题
  • 增强526认证失败错误的诊断和解决方案提示
  • 在管理界面添加授权码使用的重要提示
  • 完善各大邮箱服务商的授权码获取指南
  • 优化错误信息显示，突出显示认证失败的解决方案

v1.1.0

  • 新增系统诊断工具，检查PHP环境和扩展支持
  • 新增SMTP连接测试功能，验证服务器连接状态
  • 增强错误报告，提供详细的调试信息和日志
  • 改进测试界面，提供三级诊断步骤
  • 优化SSL/TLS连接处理和证书信息显示
  • 增加连接超时设置和性能优化

v1.0.0

  • 初始版本发布
  • 支持基础SMTP配置
  • 提供测试邮件发送功能
  • 包含详细的错误提示和调试信息

技术支持

如果您在使用过程中遇到问题，请：

  1. 查看本文档的故障排除部分
  2. 检查WordPress调试日志
  3. 联系主题开发者获取技术支持

注意：请妥善保管您的邮箱密码和授权码，不要在不安全的环境中暴露这些信息。