PHP内置服务器轻松实现前端路由回退
年卡会员这个 404 问题，终于有解了
如果你写过单页应用（SPA），大概率踩过这个坑：本地开发时一切正常，路由跳转丝般顺滑，可一旦刷新页面，或者直接访问类似 `/user/123` 的路径，服务器就毫不留情地甩给你一个 404。
原因很简单——前端路由是“假”的。你看到的 URL 变了，但服务器上并没有对应的物理文件。它只有 `index.html`，其余一切都是前端 JS 在浏览器端渲染出来的。
生产环境我们可以用 Nginx `try_files` 解决：
location / {
try_files $uri $uri/ /index.html;
}
可问题是，本地开发怎么办？如果你在用 PHP 内置服务器做联调或快速预览，默认行为跟 Nginx 一样——找不到文件就 404，贼尴尬。
PHP 内置服务器，比你想象的聪明
很多人对 `php -S localhost:8000` 的认知停留在“一个能跑 PHP 的简易 HTTP 服务器”，其实它藏了一个非常实用的功能：路由脚本（Router Script）。
通过 `-r` 参数指定一个 PHP 文件后，所有请求都会先经过这个脚本。你可以在这里自定义“当请求无法映射到真实文件时该怎么做”。
看代码：
// router.php
$path = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
// 文件或目录真实存在，直接交给内置服务器处理
if ($path !== '/' && file_exists(__DIR__ . $path)) {
return false;
}
// 其余请求统一回退到前端入口文件
require __DIR__ . '/index.html';
启动命令：
php -S localhost:8000 router.php
就这么几行，所有死活找不到的路径全部指回 `index.html`，前端路由滚动正常，页面刷新也不再白屏报错。核心思路其实和 Nginx 的 `try_files` 完全一致：有文件就给文件，没文件就给入口。
还有更进阶的玩法
上面的方案已经能解决绝大多数场景。不过有几个细节值得再抠一抠：
1. 排除静态资源
如果直接访问 `.css`、`.js`、图片路径，且文件存在，`file_exists` 检查已经放行了。但如果某次请求的路径中带有 `.css` 但文件不存在，它也会回退到 `index.html`，这可能导致 MIME 类型错乱。可以加一句：
if (preg_match('/\.(?:css|js|png|jpg|jpeg|gif|svg|ico|woff2?)$/', $path)) {
return false; // 交给服务器处理，让它自己返回 404 即可
}
2. 避免引入 PHP 框架的前端控制器冲突
如果你的内置服务器还要同时跑一些 API 接口，比如路由以 `/api/` 开头时走 PHP 后端、其余走前端 SPA，那把这个逻辑写在 `router.php` 里再合适不过了：
if (strpos($path, '/api/') === 0) {
require __DIR__ . '/api.php';
return;
}
3. 只用一行命令，不想写文件？
PHP 内置服务器也支持命令行内联参数，不过只适合逻辑极简单的场景。比如：
php -S localhost:8000 -t public public/router.php
文件方式更清晰可控，我建议还是老老实实写个 `router.php`。
知其然，也知其所以然
这个技巧的底层原理，用一句话概括：**PHP 内置服务器在收到请求时，优先尝试找真实文件；如果找不到且指定了 router 脚本，就把控制权交给 router，由你决定“最后兜底”做什么。**
很多前端开发者习惯用 Webpack Dev Server 或 Vite 的 `historyApiFallback` 解决 SPA 路由回退，但那些工具通常绑定在 Node.js 生态里。当你的项目恰好需要 PHP 来提供数据接口，或者你只是在临时环境里快速验证一个页面，PHP 内置服务器加上这个十几行的路由脚本，就是最轻量、零依赖的解法。
别小看这个平时不起眼的小工具——它比你以为的要强大得多。
