借助.htaccess优化PHP路由遇500错误求助

需求说明 #

• 带允许扩展名的文件请求，直接从static文件夹获取资源，URL无需带static前缀
• 仅带扩展名的请求视为静态文件，无扩展名的URI请求统一转发至index.php
• 限制可访问的静态文件扩展名

问题描述 #

在XAMPP环境下的php_launcher项目中，修改.htaccess配置后出现500内部服务器错误。项目文件结构如下：

- htdocs/
    |- php_launcher/
       |- static/
       |- node_modules/
       |- core/
       |- index.php
       |- .htaccess

尝试的错误配置：

RewriteEngine On
RewriteBase /php_launcher/

# Route requests to assets folder
RewriteCond %{DOCUMENT_ROOT}/assets/$1 -f
RewriteRule ^(.+) assets/$1 [L]

# Route requests to node_modules folder
RewriteCond %{DOCUMENT_ROOT}/node_modules/$1 -f
RewriteRule ^(.+) node_modules/$1 [L]

# Redirect non-existing files to index.php
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_URI} !^/static/ [NC]
RewriteRule ^ index.php [L,QSA]

# Redirect existing files to /static/
RewriteCond %{REQUEST_FILENAME} -f
RewriteRule ^ static/%{REQUEST_URI} [L,QSA]

错误信息：

Internal Server Error
The server encountered an internal error or misconfiguration and was unable to complete your request.

Please contact the server administrator at postmaster@localhost to inform them of the time this error occurred, and the actions you performed just before this error.

More information about this error may be available in the server error log.

Apache/2.4.54 (Win64) OpenSSL/1.1.1p PHP/8.1.10 Server at localhost Port 8888

错误原因 #

1. 配置中引用了不存在的assets文件夹，实际项目对应文件夹是static，导致规则无效
2. 最后一条规则引发无限循环重写：请求静态文件被重写到static/xxx后，服务器会重新处理该请求，再次触发规则并重复添加static/前缀，直到服务器达到重写次数上限，返回500错误

正确配置方案 #

以下配置完全满足需求，且避免了循环问题：

RewriteEngine On
RewriteBase /php_launcher/

# 定义允许访问的静态文件扩展名，可根据实际需求增减
RewriteCond %{REQUEST_URI} \.(css|js|png|jpg|jpeg|gif|svg|ico|woff|woff2|ttf|eot)$ [NC]
# 检查static文件夹中是否存在对应文件
RewriteCond %{DOCUMENT_ROOT}/php_launcher/static/%{REQUEST_URI} -f
# 重写请求到static文件夹下的目标文件，[L]表示停止后续规则处理
RewriteRule ^(.*)$ static/$1 [L]

# 允许直接访问node_modules下的已存在文件（若不需要可删除此段）
RewriteCond %{REQUEST_URI} ^/php_launcher/node_modules/ [NC]
RewriteCond %{REQUEST_FILENAME} -f
RewriteRule ^ - [L]

# 无扩展名或非静态文件请求，转发至index.php处理
RewriteCond %{REQUEST_URI} !\.[a-zA-Z0-9]{2,4}$ [NC]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php [L,QSA]

配置解释 #

• 静态文件路由规则：先匹配指定扩展名的请求，验证static文件夹内存在该文件后，直接重写请求路径，确保URL无需带static前缀就能获取资源
• node_modules放行规则：保留对node_modules文件夹内文件的直接访问权限（若不需要可删除）
• 动态请求转发规则：匹配无扩展名的请求，且请求的文件不存在时，统一转发到index.php处理，QSA参数保留原请求的查询字符串

内容的提问来源于stack exchange，提问作者Hind Sagar Biswas