htaccess-manager/README.md

HTACCESS Manager

一个专业的WordPress插件，用于智能管理.htaccess文件中的重定向规则。支持HTTPS强制重定向、WWW与根域名跳转配置，以及二级域名站点支持。

功能特点

🔒 强制HTTPS重定向

• 自动将所有HTTP请求重定向到HTTPS
• 确保网站安全连接

🌐 灵活的域名跳转配置

• WWW跳转到根域名：www.example.com → example.com
• 根域名跳转到WWW：example.com → www.example.com
• 自由选择跳转方向

🏷️ 二级域名支持

• 专门针对二级域名站点的优化配置
• 启用后只强制HTTPS，不处理WWW跳转

⚡ 智能规则管理

• 自动生成优化的.htaccess规则
• 不干扰其他插件的现有规则
• 安全的规则添加和移除机制

🛡️ 安全可靠

• Must-use插件支持，确保高可靠性
• 精确的规则匹配，避免误删其他配置
• 完整的卸载清理机制

安装方法

方法一：手动安装

1. 下载插件ZIP文件
2. 在WordPress后台进入【插件】→【安装插件】→【上传插件】
3. 选择ZIP文件并上传
4. 激活插件

方法二：FTP安装

1. 解压插件文件到 wp-content/plugins/htaccess-manager/
2. 在WordPress后台【插件】页面激活"HTACCESS Manager"

使用方法

基本配置

1. 进入【设置】→【HTACCESS 管理】
2. 根据您的需求配置选项：
   • 是否为二级域名：如果使用类似 sub.domain.com 的地址请启用
   • 重定向类型：选择WWW与根域名的跳转方向
   • 自动更新：启用后设置更改时自动更新.htaccess文件

配置示例

场景1：主域名站点，WWW跳转到根域名

www.example.com → example.com
http → https

配置：

• 是否为二级域名：❌ 否
• 重定向类型：✅ WWW跳转到根域名

场景2：主域名站点，根域名跳转到WWW

example.com → www.example.com
http → https

配置：

• 是否为二级域名：❌ 否
• 重定向类型：✅ 根域名跳转到WWW

场景3：二级域名站点

sub.example.com → https://sub.example.com
（不处理WWW跳转）

配置：

• 是否为二级域名：✅ 是
• 重定向类型：自动禁用

手动操作

• 复制规则：手动复制生成的规则到.htaccess文件
• 手动更新：强制更新.htaccess文件
• 移除规则：安全移除所有本插件添加的规则

生成的规则示例

WWW跳转到根域名 + HTTPS

# BEGIN HTACCESS Manager
RewriteEngine On

# 同时处理 HTTPS 和 WWW 重定向
RewriteCond %{HTTPS} off [OR]
RewriteCond %{HTTP_HOST} ^www\. [NC]
RewriteCond %{HTTP_HOST} ^(?:www\.)?(.+)$ [NC]
RewriteRule ^ https://%1%{REQUEST_URI} [L,R=301]
# END HTACCESS Manager

二级域名 + 只强制HTTPS

# BEGIN HTACCESS Manager
RewriteEngine On

# 强制HTTPS重定向（二级域名）
RewriteCond %{HTTPS} off
RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
# END HTACCESS Manager

兼容性

测试环境

• ✅ WordPress 5.0+
• ✅ PHP 7.4+
• ✅ Apache 2.4+
• ✅ LiteSpeed（含OpenLiteSpeed和LiteSpeed Enterprise）服务器
• ✅ 多站点网络

插件兼容

• ✅ 与大多数缓存插件兼容
• ✅ 与安全插件兼容
• ✅ 不影响其他.htaccess规则生成插件

故障排除

常见问题

Q: 插件激活后网站出现重定向循环？ A: 检查服务器是否已配置SSL证书，或尝试清除浏览器缓存。

Q: .htaccess文件无法写入？ A: 确保.htaccess文件权限设置为644，或使用手动复制功能。

Q: 规则没有生效？ A: 确认服务器支持mod_rewrite模块，检查Apache配置。如果是OpenLiteSpeed服务器，可能需要重启OpenLiteSpeed服务。

Q: 如何恢复默认设置？ A: 停用并重新激活插件，或使用"移除规则"功能。

日志检查

如果遇到问题，请检查：

1. WordPress调试日志
2. 服务器错误日志
3. .htaccess语法验证

开发者信息

文件结构

htaccess-manager/
├── htaccess-manager.php      # 主插件文件
├── readme.md                 # 说明文档
└── (自动生成)
    └── mu-plugins/
        └── htaccess-helper.php  # Must-use插件

钩子函数

插件提供以下WordPress钩子：

• htaccess_manager_before_update - 规则更新前
• htaccess_manager_after_update - 规则更新后

自定义开发

如需扩展功能，可参考插件中的规则生成逻辑：

$manager = new HTACCESS_Manager();
$rules = $manager->generate_htaccess_rules();

版本历史

v1.0.2 (当前版本)

• 增强规则移除安全性
• 改进空行处理
• 优化MU插件逻辑

v1.0.1

• 修复规则冲突问题
• 添加内容预览功能
• 改进用户界面

v1.0.0

• 初始发布
• 基础重定向功能
• Must-use插件支持

技术支持

如果您遇到问题或需要帮助，请：

1. 查看本README文档
2. 检查WordPress错误日志
3. 联系服务器管理员确认Apache配置

许可证

GPL v2或更高版本

贡献

欢迎提交Issue和Pull Request来帮助改进这个插件。

---

注意：（1）在使用本插件前，请务必备份您的.htaccess文件。

（2）本插件不适用于Nginx服务器。