本文介绍如何通过 Apache 的 .htaccess 和主配置协同实现：仅对指定目录（如 /lib）内的 PHP 文件隐藏 .php 扩展，同时确保脚本正常执行，且不干扰其子目录及站点根目录的路由逻辑。
本文介绍如何通过 apache 的 .htaccess 和主配置协同实现：仅对指定目录（如 `/lib`）内的 php 文件隐藏 `.php` 扩展，同时确保脚本正常执行，且不干扰其子目录及站点根目录的路由逻辑。
要精准控制 PHP 扩展名的隐藏范围——例如仅对项目根目录下的主页面（如 index.php、about.php）和 /lib/ 目录下的工具脚本生效，而排除 /lib/ 下的子目录（如 /lib/utils/、/lib/classes/）——必须避免全局重写规则带来的副作用。错误地在根目录或 /lib/ 中启用无条件内部重定向，极易导致 PHP 脚本被当作静态资源处理（返回 404 或源码暴露），或引发循环重定向。
✅ 正确做法是采用「分层控制 + 显式匹配」策略：
-
在 /lib/.htaccess 中仅启用「URL 重写输出」（即美化请求路径），不触发内部重定向：
# /lib/.htaccess RewriteEngine On RewriteBase /lib/ # 将 /lib/script → 内部映射为 /lib/script.php（仅当真实文件存在） RewriteCond %{REQUEST_FILENAME}.php -f RewriteRule ^(.+)$ $1.php [L]⚠️ 注意：此处 RewriteRule 是 内部转发（隐式），而非外部跳转；[L] 确保终止当前规则链；RewriteCond 检查 .php 文件是否存在，防止误匹配。
立即学习“PHP免费学习笔记（深入）”；
-
在站点根目录 .htaccess（或虚拟主机配置 <Directory> 块）中统一处理主页面：
# 根目录 .htaccess RewriteEngine On RewriteBase /
优先匹配已存在的 .php 文件（根目录下）
RewriteCond %{REQUEST_FILENAME}.php -f RewriteRule ^([^./]+)$ $1.php [L]
可选：兼容带斜杠的伪目录（如 /admin → /admin.php）
RewriteCond %{REQUEST_FILENAME}.php -f RewriteRule ^(.+)/$ $1.php [L]
3. **关键防护：禁止规则向下继承到子目录** 在 `/lib/utils/.htaccess`、`/lib/classes/.htaccess` 等需排除的子目录中，**显式关闭重写引擎**： ```apache # /lib/utils/.htaccess RewriteEngine Off
或使用 RewriteOptions InheritDownOff（Apache 2.4.8+）阻止父级规则继承。
? 验证要点：
- 访问 https://example.com/lib/db_connect → 应成功加载 lib/db_connect.php；
- 访问 https://example.com/lib/utils/helper.php → 应直接返回 PHP 源码（或 404），绝不被重写为 helper.php.php；
- 访问 https://example.com/contact → 加载 contact.php（根目录）；
- 所有 .php 文件仍可通过原始 URL（如 /lib/db_connect.php）直接访问（便于调试）。
? 总结：
- ❌ 避免使用 RewriteRule ^(.+)\.php$ $1 这类纯正则替换（它仅改写 URL，未触发实际文件映射，常导致 404）；
- ✅ 始终结合 RewriteCond %{REQUEST_FILENAME}.php -f 做存在性校验；
- ✅ 利用子目录独立 .htaccess 实现“白名单式”控制，比复杂正则更可靠、更易维护；
- ?️ 生产环境建议将核心规则移至 Apache 主配置（httpd.conf 或 site-available），提升性能并规避 .htaccess 覆盖风险。
