本文详解如何利用 .htaccess 文件中的 mod_rewrite 规则，将 domain/pages/asd.php 这类带中间目录的 URL 隐藏为简洁的 domain/asd.php，实现路径美化与结构隔离，同时阻止原始路径直接访问。
本文详解如何利用 `.htaccess` 文件中的 `mod_rewrite` 规则，将 `domain/pages/asd.php` 这类带中间目录的 url 隐藏为简洁的 `domain/asd.php`，实现路径美化与结构隔离，同时阻止原始路径直接访问。
在 Web 开发中，常需将 PHP 文件统一存放在子目录（如 /pages/）以保持项目结构清晰，但又不希望该目录暴露在用户可见的 URL 中——既提升安全性（减少路径泄露风险），也优化用户体验与 SEO 友好性。Apache 的 mod_rewrite 模块提供了强大且标准的解决方案，无需修改代码逻辑，仅通过服务器配置即可完成“路径透明化”。
✅ 核心目标
- 用户访问 https://domain/asd.php → 正确加载 /pages/asd.php 内容
- 用户尝试访问 https://domain/pages/asd.php → 被重定向或拒绝（推荐 301 重定向 + 内部重写组合）
- 所有静态资源、相对链接、表单提交等仍能正常工作（因实际脚本执行路径不变）
✅ 推荐 .htaccess 配置（置于网站根目录）
RewriteEngine On
# 【步骤1】外部重定向：禁止直接访问 /pages/ 路径（301 强制跳转）
RewriteRule ^pages/(.+)$ /$1 [R=301,L]
# 【步骤2】内部重写：将干净路径映射回真实路径（仅当文件不存在时触发）
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.+\.php)$ /pages/$1 [END]
? 说明：
Apache Tika Content Extraction Hub下载通过Apache Tika Server REST API从1400多种文件格式中提取文本和元数据。处理PDF、DOCX、PPTX、电子邮件归档以及带有MIME类型检测的嵌入式文档提取。
- 第一条规则对所有匹配 ^pages/... 的请求发起 301 永久重定向，强制浏览器跳转至无 /pages/ 的简洁 URL；
- 后两条 RewriteCond 确保仅当请求的 .php 文件在根目录不存在（!-f）且不是真实目录（!-d）时，才触发内部重写，将 /asd.php 映射到 /pages/asd.php；
- [END] 标志防止后续规则重复处理，比 [L] 更安全（避免循环重写）。
⚠️ 注意事项
- ✅ 确保 Apache 已启用 mod_rewrite 模块，并在虚拟主机配置中设置 AllowOverride All（否则 .htaccess 不生效）；
- ✅ .htaccess 文件必须保存为 UTF-8 无 BOM 格式，放置于网站根目录（与 pages/ 同级）；
- ❌ 不要使用 [QSA] 或 [NC] 等冗余标记，除非有特殊需求（如大小写兼容或保留查询参数）；
- ?️ 此方案不替代权限控制：敏感文件仍需配合 Deny from all 或 Require local 等访问限制；
- ? 若使用 Nginx，需改用 try_files + rewrite 指令，语法完全不同（本文不展开）。
✅ 验证是否生效
- 访问 https://yourdomain.com/pages/test.php → 应自动跳转至 https://yourdomain.com/test.php（地址栏变化，状态码 301）；
- 访问 https://yourdomain.com/test.php → 页面正常加载，且服务端 $_SERVER['SCRIPT_FILENAME'] 仍指向 /pages/test.php（逻辑不受影响）；
- 查看 Chrome DevTools → Network 标签 → 确认重定向链清晰，无 500/404 错误。
通过以上配置，你实现了 URL 路径的“语义隐藏”：用户看到的是扁平、专业的路由，而开发者保有清晰的物理目录结构。这是一种轻量、可靠、符合 Web 最佳实践的路径抽象方式。
