php apache伪静态 mod_rewrite

封面图 • 2025-10-09 • PHP

在使用 **PHP + Apache** 开发 Web 应用时，**伪静态（Rewrite）** 是一种常见的技术，用于将动态 URL 转换为更友好的“静态”格式。Apache 的 `mod_rewrite` 模块是实现这一功能的核心组件。

---

## ✅ 一、启用 `mod_rewrite`

确保 Apache 已启用 `mod_rewrite` 模块：

### 方法 1：通过命令行（Linux/Unix）

```bash
sudo a2enmod rewrite
sudo systemctl restart apache2
```

### 方法 2：手动编辑 Apache 配置文件

打开 Apache 的配置文件（如 `/etc/apache2/apache2.conf` 或 `/etc/httpd/conf/httpd.conf`），找到以下部分并取消注释：

```apache
LoadModule rewrite_module modules/mod_rewrite.so
```

然后重启 Apache：

```bash
sudo apachectl restart
```

---

## ✅ 二、配置 `.htaccess` 文件

创建一个 `.htaccess` 文件在你的网站根目录（例如 `/var/www/html/.htaccess`），并添加以下内容：

```apache
RewriteEngine On
RewriteBase /

# 如果请求的是真实存在的文件或目录，则不进行重写
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d

# 将所有请求重写到 index.php
RewriteRule ^(.*)$ index.php?path=$1 [L,QSA]
```

> **说明：**
- `RewriteEngine On`：开启重写引擎。
- `RewriteBase /`：设置基础路径。
- `RewriteCond`：条件判断，如果请求的不是真实文件或目录，则继续。
- `RewriteRule`：将所有请求重写到 `index.php`，并将路径作为参数传递。

---

## ✅ 三、PHP 中处理伪静态请求

在 `index.php` 中可以获取 `$_GET['path']` 参数来解析用户访问的“伪静态”路径。

```php
<?php
$path = $_GET['path'] ?? '';
echo "你访问的路径是: " . htmlspecialchars($path);
?>
```

---

## ✅ 四、示例：实现类似 `/user/123` 的 URL

假设你想让 `/user/123` 显示用户 ID 为 123 的信息，可以在 `.htaccess` 中这样写：

```apache
RewriteEngine On
RewriteBase /

# 匹配 /user/数字 的路径
RewriteRule ^user/([0-9]+)$ user.php?id=$1 [L]
```

在 `user.php` 中：

```php
<?php
$id = $_GET['id'] ?? '';
echo "用户 ID: " . htmlspecialchars($id);
?>
```

---

## ✅ 五、注意事项

| 项目 | 说明 |
|------|------|
| `.htaccess` 权限 | 确保 Apache 有权限读取 `.htaccess` 文件 |
| `AllowOverride` | 在 Apache 配置中，确保 `AllowOverride All` 被启用（通常在 `<Directory>` 块中） |
| 日志排查 | 查看 Apache 的日志文件（如 `/var/log/apache2/error.log`）调试问题 |

---

## ✅ 六、Apache 配置示例（`<Directory>` 设置）

在 Apache 的虚拟主机配置中，确保允许 `.htaccess` 文件生效：

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

---

## ✅ 七、测试伪静态是否生效

你可以访问如下 URL 进行测试：

- `http://yourdomain.com/user/123`
- `http://yourdomain.com/about`
- `http://yourdomain.com/contact`

如果一切正常，这些 URL 会指向你定义的 PHP 文件。

---

如果你需要更复杂的重写规则（比如 RESTful API、多级路径等），可以告诉我具体需求，我可以帮你写对应的 `.htaccess` 规则。