解决.htaccess重定向循环：以HTTP到子域名为例

本教程深入探讨.htaccess文件中常见的重定向循环问题，特别是当尝试将http请求重定向到特定子域名时。我们将分析导致循环的常见模式，并提供基于`rewritecond`指令的解决方案，确保重定向在满足特定条件时才执行，从而避免“重定向次数过多”的错误。文章还涵盖了`.htaccess`配置的最佳实践，以构建健壮的url重写规则。

理解.htaccess重定向循环

.htaccess文件是Apache服务器中用于配置目录级别重写规则的强大工具。然而，不当的配置，尤其是重定向规则，很容易导致“重定向次数过多”（Too Many Redirects）的错误。这种错误通常发生在服务器尝试将请求从一个URL重定向到另一个URL，而这个目标URL又被规则重定向回原始URL，或者重定向到一个同样会触发自身重定向的URL，从而形成一个无限循环。

最常见的重定向循环场景包括：

1. HTTP到HTTPS重定向：如果规则将HTTP请求重定向到HTTPS，但没有检查当前协议是否已经是HTTPS，则当请求已经是HTTPS时，规则可能仍尝试重定向，导致循环。
2. 非www到www或反向重定向：类似地，如果规则将example.com重定向到www.example.com，但没有检查当前主机名是否已经是www.example.com。
3. 子域名重定向：将请求重定向到特定的子域名，但未检查请求是否已在该子域名上。

分析HTTP到子域名重定向的循环问题

考虑一个常见的需求：将所有HTTP请求重定向到一个特定的子域名（例如sub.example.com）。一个初学者可能会编写如下的.htaccess规则：

RewriteEngine On
RewriteCond %{SERVER_PORT} 80
RewriteRule ^(.*)$ http://sub.example.com/$1 [R,L]

这条规则的意图是，当请求通过HTTP（端口80）访问时，将其重定向到http://sub.example.com。然而，如果请求本身就是针对http://sub.example.com的HTTP请求，这条规则将再次被触发，因为它满足%{SERVER_PORT} 80的条件。服务器会不断地将http://sub.example.com/path重定向到http://sub.example.com/path，从而形成一个无限循环，最终导致浏览器报错“重定向次数过多”。

问题的核心在于，规则只检查了协议（HTTP），但没有检查请求的目标主机名是否已经是我们希望重定向到的子域名。

解决重定向循环：添加主机名条件

为了避免重定向循环，我们需要在重定向规则中添加一个额外的条件，以确保只有当请求的主机名不是目标子域名时才执行重定向。这可以通过RewriteCond %{HTTP_HOST}指令来实现。

假设我们的目标子域名是sub.example.com。修正后的规则如下：

RewriteEngine On
RewriteCond %{SERVER_PORT} 80
RewriteCond %{HTTP_HOST} !^sub\.example\.com$ [NC]
RewriteRule ^(.*)$ http://sub.example.com/$1 [R,L]

规则解析：

• RewriteEngine On: 启用重写引擎。
• RewriteCond %{SERVER_PORT} 80: 这是一个条件，检查当前请求是否通过HTTP（端口80）接收。
• RewriteCond %{HTTP_HOST} !^sub\.example\.com$ [NC]: 这是关键的修复。
  • %{HTTP_HOST}: 获取请求头中的主机名（例如www.example.com或example.com）。
  • !^sub\.example\.com$: 使用正则表达式匹配，!表示“不匹配”。它检查当前主机名是否不是sub.example.com。
  • [NC]: No Case，表示不区分大小写匹配。
• RewriteRule ^(.*)$ http://sub.example.com/$1 [R,L]: 如果上述两个条件都满足，则执行重定向。
  • ^(.*)$: 匹配所有请求路径。
  • http://sub.example.com/$1: 将请求重定向到http://sub.example.com，并保留原始请求路径。
  • [R,L]: R表示执行外部重定向（发送302状态码，浏览器会看到URL变化），L表示Last，即如果此规则匹配并执行，则停止处理后续的重写规则。

简化RewriteRule：

上述RewriteRule可以进一步简化，利用%{REQUEST_URI}变量直接获取请求的URI部分，而无需使用捕获组(.*)：

RewriteEngine On
RewriteCond %{SERVER_PORT} 80
RewriteCond %{HTTP_HOST} !^sub\.example\.com$ [NC]
RewriteRule ^ http://sub.example.com%{REQUEST_URI} [R,L]

这条规则的效果与之前相同，但更简洁。

NameGPT名称生成器

免费AI公司名称生成器，AI在线生成企业名称，注册公司名称起名大全。

0

查看详情

.htaccess配置最佳实践

除了解决重定向循环，以下是一些编写健壮.htaccess规则的通用最佳实践：

1. 统一RewriteEngine On: 整个.htaccess文件只需要一个RewriteEngine On指令。重复出现会造成冗余，虽然通常不会引起错误，但不利于维护。

2. 重定向规则的顺序: 将主要的重定向规则（如HTTP到HTTPS，非www到www/子域名）放在文件顶部，因为它们通常是全局性的，并且带有[L]标志会阻止后续规则的执行。

3. 使用HTTPS: 现代Web开发中，HTTPS是标准。强烈建议将所有HTTP流量重定向到HTTPS。这通常与子域名重定向结合使用。

   # 将所有HTTP请求重定向到HTTPS
   RewriteCond %{SERVER_PORT} 80
   RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]
   
   # 然后处理子域名重定向 (如果需要)
   RewriteCond %{HTTP_HOST} !^sub\.example\.com$ [NC]
   RewriteRule ^ https://sub.example.com%{REQUEST_URI} [R=301,L]

   登录后复制

   请注意，这里使用了R=301，表示永久重定向，有利于SEO。

4. 处理文件扩展名: 如果需要隐藏.php等文件扩展名，可以这样配置：

   # 隐藏.php扩展名
   RewriteCond %{REQUEST_FILENAME} !-d
   RewriteCond %{REQUEST_FILENAME}\.php -f
   RewriteRule ^(.*)$ $1.php [NC,L]

   登录后复制

5. 自定义404错误页面:

   # 自定义404页面
   ErrorDocument 404 /404.php
   
   # 也可以使用RewriteRule来处理，但ErrorDocument更直接
   # RewriteCond %{REQUEST_FILENAME} !-f
   # RewriteCond %{REQUEST_FILENAME} !-d
   # RewriteRule ^(.*)$ /404.php [L]

   登录后复制

完整示例配置

结合上述最佳实践，一个更完善的.htaccess配置可能如下：

# 启用重写引擎
RewriteEngine On

# 1. 将所有HTTP请求重定向到HTTPS (如果适用)
# 强烈推荐使用HTTPS
RewriteCond %{SERVER_PORT} 80
RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]

# 2. 将非sub.example.com的请求重定向到sub.example.com (如果当前不是sub.example.com)
# 确保在HTTPS重定向之后执行，或者直接重定向到HTTPS的子域名
RewriteCond %{HTTP_HOST} !^sub\.example\.com$ [NC]
RewriteRule ^ https://sub.example.com%{REQUEST_URI} [R=301,L]

# 3. 隐藏.php文件扩展名
# 确保请求的文件不是目录，且存在对应的.php文件
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME}\.php -f
RewriteRule ^(.*)$ $1.php [NC,L]

# 4. 自定义404错误页面
# 如果请求的文件或目录不存在，则显示404.php
ErrorDocument 404 /404.php

# 或者使用RewriteRule（不推荐与ErrorDocument同时使用，可能冲突）
# RewriteCond %{REQUEST_FILENAME} !-f
# RewriteCond %{REQUEST_FILENAME} !-d
# RewriteRule ^(.*)$ /404.php [L]

注意事项：

• 测试: 修改.htaccess文件后，务必清除浏览器缓存并进行彻底测试。重定向循环可能被浏览器缓存。
• 正则表达式: 正则表达式中的点.需要转义为\.，以匹配字面意义上的点，而不是任何字符。
• [R]与[R=301]: [R]默认发送302临时重定向，[R=301]发送301永久重定向。301对搜索引擎优化（SEO）更有利，但一旦设置，浏览器和搜索引擎会缓存这个重定向，更改起来更麻烦。在开发阶段可以使用302，部署上线后改为301。
• 服务器配置: 某些服务器环境可能不允许用户在.htaccess中覆盖所有RewriteEngine指令。如果规则不生效，请检查服务器的AllowOverride配置。

总结

解决.htaccess重定向循环的关键在于精确的条件判断。在进行任何形式的URL重定向时，务必使用RewriteCond指令来检查当前请求的协议、主机名、路径等是否已经处于目标状态。只有当请求不符合目标状态时才执行重定向，这样才能有效避免无限循环。遵循最佳实践，合理组织和测试你的.htaccess规则，将有助于构建一个高效且无错误的Web服务器配置。

以上就是解决.htaccess重定向循环：以HTTP到子域名为例的详细内容，更多请关注php中文网其它相关文章！