本文介绍如何通过 apache 的 .htaccess 和主配置协同实现：仅对指定目录（如 /lib）内的 php 文件隐藏 .php 扩展，同时确保脚本正常执行，且不干扰子目录及根目录页面的路由逻辑。
本文介绍如何通过 apache 的 .htaccess 和主配置协同实现：仅对指定目录（如 /lib）内的 php 文件隐藏 .php 扩展，同时确保脚本正常执行，且不干扰子目录及根目录页面的路由逻辑。
要在特定文件夹（例如 /lib）中安全地移除 PHP 文件扩展名，同时避免破坏脚本执行、不波及子目录、并兼顾根目录页面的友好 URL，需采用“分层重写”策略——即在目标目录内禁用扩展名显示，在服务器全局层面按需补全扩展名，而非简单启用 MultiViews 或全局重写。
✅ 正确做法：目录级限制 + 全局智能补全
1. 在 /lib/.htaccess 中添加（仅影响该目录，不继承到子目录）
# 禁用目录列表，启用重写
Options -Indexes
RewriteEngine On
# 将形如 "helper.php" 的请求重写为 "helper"（仅用于 URL 显示/访问）
# 注意：此规则不改变实际文件路径，仅修饰请求 URI
RewriteRule ^(.+)\.php$ $1 [R=301,L]
# 可选：防止直接访问 .php 文件（增强安全性）
RewriteCond %{THE_REQUEST} \.php [NC]
RewriteRule ^(.+)\.php$ /$1 [R=301,L]⚠️ 注意：上述 R=301 是外部重定向，适用于用户可见链接美化；若需内部重写（不改变浏览器地址栏），请改用 [L] 并配合主配置补全逻辑。
2. 在主 Apache 配置（httpd.conf 或虚拟主机配置）中启用智能解析
<Directory "/var/www/html">
RewriteEngine On
# 仅当请求路径不包含点号（即无扩展名）且对应 .php 文件存在时，才内部补全
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME}.php -f
RewriteRule ^([^./]+)$ $1.php [QSA,L]
</Directory>✅ 该逻辑确保：
- /about → 自动映射到 /about.php（根目录）
- /lib/utils → 自动映射到 /lib/utils.php（因 /lib/.htaccess 不阻止此行为）
- /lib/cache/ 或 /lib/internal/ 等子目录不受影响（无匹配规则，不触发重写）
3. 关键注意事项
- ❌ 不要在 /lib/.htaccess 中使用 RewriteRule ^(.+)$ $1.php —— 这将导致无限循环或 500 错误；
- ✅ 必须启用 mod_rewrite 并确认 AllowOverride All 在对应 <Directory> 块中已设置；
- ? 生产环境建议关闭 FollowSymLinks（除非必要），并在 .htaccess 开头添加 Options -FollowSymLinks；
- ? 测试时清除浏览器缓存（301 重定向会被缓存），或临时改用 R=302。
总结
真正安全的“去扩展名”方案不是单靠 .htaccess 完成，而是结合目录级访问控制与服务器级条件化补全。它既满足 /lib/utils 这类内部调用的简洁性，又保障 /lib/legacy/old_script.php 等子目录文件不受干扰，同时让根目录的 /contact 自然指向 /contact.php。务必避免全局暴力重写，始终以 RewriteCond 显式校验文件存在性，这是稳定性和可维护性的基石。
立即学习“PHP免费学习笔记（深入）”；
