.htaccess前端控制器规则导致静态资源无法加载及自定义路由适配问题咨询

首先，咱们先梳理下你现有配置里的几个核心问题：

1. 静态资源放行规则位置不对且覆盖不全：你只单独处理了img目录，却漏掉了css和js，而且这些规则放在了路由和404规则之后，导致静态资源请求先被后面的规则拦截，根本没机会触发放行逻辑。
2. PHP文件保护规则有误：原规则会拦截所有PHP文件，包括你的前端控制器index.php，直接访问/index.php会返回404，这显然不合理。
3. 规则顺序错误：自定义路由规则如果放在通用路由之后，会被通用路由先匹配，导致你的自定义参数（比如faculty）无法生效。

修改后的完整.htaccess配置 #

# 设置RewriteBase为网站根目录
RewriteBase /

# 第一步：优先放行已存在的文件和目录
# 所有存在的静态资源（css/js/img里的文件）、目录都会直接返回，不执行后续规则
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

# 第二步：保护PHP文件，仅允许访问index.php
# 禁止直接访问除index.php外的其他PHP文件，避免敏感文件暴露
RewriteCond %{REQUEST_URI} !^/index\.php$
RewriteCond %{REQUEST_URI} \.php$
RewriteRule ^ - [R=404,L]

# 第三步：添加自定义路由规则（放在通用路由之前）
# 这里可以添加所有需要特定参数的自定义路由，按需求扩展
RewriteRule ^study-programmes/(.*)$ index.php?site=study-programmes&faculty=$1 [QSA,L]
# 示例：添加其他自定义路由
# RewriteRule ^courses/(.*)/details$ index.php?site=courses&course=$1&action=details [QSA,L]

# 第四步：通用路由规则，处理所有未匹配的请求
# 将其他请求转发到index.php，通过site参数传递路径
RewriteRule ^(.*)$ index.php?site=$1 [QSA,L]

关键调整说明 #

1. 静态资源放行逻辑：
   把-f（存在的文件）和-d（存在的目录）的判断放在最前面，只要请求的是真实存在的文件/目录，直接返回不做后续处理。这样css/style.css、js/main.js、img/logo.png这些请求都会被直接放行，不会被后面的路由规则拦截。

2. PHP文件保护优化：
   添加了!^/index\.php$的条件，排除了前端控制器index.php，既保护了其他PHP文件不被直接访问，又保证了前端控制器可以正常工作。

3. 自定义路由的顺序：
   所有自定义路由规则必须放在通用路由规则之前，因为Apache的RewriteRule是按从上到下的顺序匹配的，先匹配到的规则会先执行（[L]标志会终止后续规则）。这样study-programmes/engineering这类请求会先被自定义规则捕获，正确传递faculty=engineering参数，而不会被通用路由处理成site=study-programmes/engineering。

4. QSA标志的作用：
   保留[QSA]标志可以确保原请求的查询参数（比如?foo=bar）会被追加到新的URL后面，不会丢失参数。

额外注意事项 #

• 如果你的自定义路由有更复杂的匹配需求（比如限制faculty只能是字母数字），可以把规则改成更严格的模式，比如：

  RewriteRule ^study-programmes/([a-zA-Z0-9-]+)$ index.php?site=study-programmes&faculty=$1 [QSA,L]
  

• 测试配置时，可以先清空浏览器缓存，避免之前的错误缓存影响结果。也可以使用Apache的rewrite.log来调试规则匹配过程。

内容的提问来源于stack exchange，提问作者Minoangelo