启用 Apache Rewrite 重写模块的详细指南

Apache 的 Rewrite 模块（mod_rewrite）是一个非常强大的 URL 重写引擎，允许你基于各种条件重写 URL。以下是启用和使用这个模块的详细步骤：

1. 检查模块是否已启用

首先检查 mod_rewrite 是否已经启用：

apache2ctl -M | grep rewrite

或者对于较旧版本的 Apache：

httpd -M | grep rewrite

如果看到 rewrite_module 表示已启用。

2. 启用 mod_rewrite 模块

在 Ubuntu/Debian 系统上：

sudo a2enmod rewrite
sudo systemctl restart apache2

在 CentOS/RHEL/Fedora 系统上：

编辑 /etc/httpd/conf/httpd.conf 文件，确保有以下行（取消注释）：

LoadModule rewrite_module modules/mod_rewrite.so

然后重启 Apache：

sudo systemctl restart httpd

3. 配置目录允许 .htaccess 重写

编辑 Apache 的虚拟主机配置文件（通常在 /etc/apache2/sites-available/000-default.conf 或类似位置）：

<Directory /var/www/html>
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

关键点是 AllowOverride All，这允许 .htaccess 文件覆盖配置。

4. 重启 Apache 服务

应用更改：

# Ubuntu/Debian
sudo systemctl restart apache2

# CentOS/RHEL
sudo systemctl restart httpd

5. 创建 .htaccess 文件测试

在网站根目录（如 /var/www/html）创建 .htaccess 文件：

RewriteEngine On
RewriteRule ^test$ index.html [NC]

这会使得访问 /test 时显示 index.html 内容。

6. 验证重写是否工作

访问 http://yourdomain.com/test，应该看到与 index.html 相同的内容。

高级配置示例

基本重定向

RewriteEngine On
RewriteRule ^oldpage\.html$ newpage.html [R=301,L]

条件重写

RewriteCond %{HTTP_HOST} ^example\.com [NC]
RewriteRule ^(.*)$ http://www.example.com/$1 [R=301,L]

隐藏文件扩展名

RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME}\.php -f
RewriteRule ^(.*)$ $1.php

常见问题解决

1. 重写不生效：

   • 确保 AllowOverride All 已设置
   • 检查 Apache 错误日志：tail -f /var/log/apache2/error.log
   • 确保 .htaccess 文件名正确（前面有点）

2. 500 服务器错误：

   • 通常是 .htaccess 语法错误
   • 逐行检查重写规则

3. 权限问题：

   • 确保 Apache 用户有权限读取 .htaccess 文件

通过以上步骤，你应该能够成功启用并使用 Apache 的 Rewrite 模块来实现各种 URL 重写需求。