本地PHP+XAMPP环境路由问题及静态文件访问故障求助

核心问题分析 #

你的问题本质是URL重写规则未排除静态资源，加上本地环境的RewriteBase配置可能与生产服务器不一致，导致了静态文件404和路径匹配异常。以下是针对性的修复方案：

1. 修复静态文件404（关键步骤） #

当前规则会把所有非目录请求都尝试重写为.php文件，包括图片、CSS、JS这类静态资源，自然返回404。需要在重写规则最前面添加放行静态资源的逻辑：

在RewriteEngine On之后插入这段代码：

# 放行已存在的文件、目录，直接返回真实资源
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

这段代码的作用是：如果请求的是真实存在的文件（比如/assets/logo.jpg）或目录，直接跳过后续重写规则，返回原始资源。

2. 修正RewriteBase配置 #

生产服务器上网站可能部署在根目录，但本地XAMPP如果把网站放在htdocs的子文件夹（比如htdocs/my-php-project），默认的RewriteBase /会失效，导致所有重写路径错误。你需要根据本地项目路径调整：

• 若项目在http://localhost/my-php-project/，则改为：RewriteBase /my-php-project/
• 若直接放在XAMPP根目录（htdocs下），保持RewriteBase /即可。

3. 完整修正后的.htaccess代码 #

Options +FollowSymLinks -MultiViews
RewriteEngine On
# 根据本地项目路径调整此行
RewriteBase /

# 放行已存在的文件、目录
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

# 错误页面配置
ErrorDocument 403 /403.php
ErrorDocument 404 /404.php

# 隐藏.php扩展名：外部跳转（带.php的URL跳转到无后缀版本）
RewriteCond %{THE_REQUEST} \s/+(.+?)\.php[\s?] [NC]
RewriteRule ^ /%1 [R=301,NE,L]

# 隐藏.php扩展名：内部重写（无后缀URL指向对应.php文件）
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{DOCUMENT_ROOT}/$1.php -f
RewriteRule ^(.+?)/?$ $1.php [L]

# 自定义路由规则
RewriteRule ^trade/(.*)$ find-trade?id=$1 [NC,L]
RewriteRule ^user/profile/(.*)$ profile.php?id=$1 [NC,L]
RewriteRule ^inventory/profile/(.*)$ profile.php?id=$1&inventory=true [NC,L]
RewriteRule ^trades/profile/(.*)$ profile.php?id=$1&trades=true [NC,L]
RewriteRule ^bump/(.*)$ bump.php?id=$1 [NC,L]

关于php -S内置服务器的补充说明 #

PHP内置服务器本身不支持.htaccess的URL重写规则，若想用它无后缀访问页面，需要自定义路由脚本（比如router.php），然后用php -S localhost:8000 router.php启动服务器。示例路由脚本如下：

<?php
$requestUri = $_SERVER['REQUEST_URI'];
$requestUri = strtok($requestUri, '?'); // 去掉查询字符串

// 匹配无后缀URL到对应.php文件
$targetFile = __DIR__ . $requestUri;
if (file_exists($targetFile . '.php')) {
    require $targetFile . '.php';
    exit;
}

// 处理自定义路由（对应原.htaccess规则）
if (preg_match('#^/trade/(.*)$#', $requestUri, $matches)) {
    $_GET['id'] = $matches[1];
    require __DIR__ . '/find-trade.php';
    exit;
}

// 其他路由可参照上面的格式添加，默认加载首页
require __DIR__ . '/index.php';
?>

不过更推荐使用XAMPP的Apache环境，因为它更贴近生产服务器配置，能减少环境差异带来的问题。

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