虚拟目录重写是将用户访问路径(如/blog/123)内部映射到真实脚本(如/index.php?section=blog&id=123)且地址栏不变,需满足启用mod_rewrite、allowoverride all和options +followsymlinks,并在.htaccess中去掉规则开头斜杠,同时用!-f和!-d排除真实文件与目录以避免冲突。

虚拟目录重写不是指“创建一个假目录”,而是让 Apache 把用户访问某个路径(比如 /blog/123)的行为,内部映射到真实存在的脚本或文件(比如 /index.php?section=blog&id=123),同时保持浏览器地址栏不变。关键在于:路径匹配不带开头斜杠、规则必须放在正确的上下文里、避免和真实文件冲突。
虚拟目录重写的环境前提
规则要生效,必须满足三个硬性条件:
- mod_rewrite 模块已启用(
LoadModule rewrite_module modules/mod_rewrite.so已取消注释) - 目标目录的
<directory></directory>块中设置了AllowOverride All和Options +FollowSymLinks - 如果用 .htaccess,它必须位于该虚拟目录的物理根路径下;如果直接写在 VirtualHost 中,则需包裹在
<directory></directory>内
路径匹配写法:去掉开头斜杠
在 .htaccess 或 <directory></directory> 中写规则时,Apache 会自动剥离当前目录前缀。所以匹配 /shop/product/2026 这样的请求,模式不能写成 ^/shop/product/([0-9]+)$,而应写成:
RewriteRule ^shop/product/([0-9]+)$ /router.php?module=shop&action=product&id=$1 [L,QSA,NC]
注意:
• ^shop/... 开头没有斜杠
• $1 引用括号捕获的数字
• [QSA] 确保原始 URL 中的 ?ref=abc 也能传给 router.php
排除真实文件和目录(防冲突)
否则访问 /css/style.css 或 /images/logo.png 也会被错误重写。加两行判断:
Apache Superset 是一个广泛采用的开源 BI 平台,用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时,此技能非常有用。
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^([a-z]+)/([a-z]+)/([0-9]+)$ /index.php?section=$1&page=$2&id=$3 [L,QSA]
这样只有当请求路径既不是真实文件、也不是真实目录时,才触发重写。
常见虚拟目录场景示例
• 把 /user/john 映射为 /profile.php?username=john:RewriteRule ^user/([^/]+)$ /profile.php?username=$1 [L,QSA]
• 把 /api/v2/posts/456 转给 /api/handler.php 并传递版本与ID:RewriteRule ^api/v([0-9]+)/posts/([0-9]+)$ /api/handler.php?version=$1&type=posts&id=$2 [L,QSA]
• 支持可选尾部斜杠:RewriteRule ^article/([0-9]+)(/?)$ /article.php?id=$1 [L,QSA]










