PHP内置服务器不支持重写，必须手动指定router.php路由脚本；该脚本需检查静态文件存在性并返回false交由服务器处理，否则自行分发请求，且无法模拟子目录部署或识别.htaccess。
PHP内置服务器默认不支持重写，必须手动指定路由器脚本
PHP内置服务器（php -S）本身没有Apache或Nginx那样的URL重写能力。它只做静态文件服务和简单路由分发，所有动态请求（比如 /user/123 或 /api/posts）都必须由你提供的路由器脚本统一接管——否则直接返回404。
这意味着：你不能靠配置文件开启“路由支持”，必须显式传入一个 .php 路由器文件作为第三个参数。
- 正确启动方式：
php -S localhost:8000 router.php - 错误做法：
php -S localhost:8000（没路由器，深层路径全404） - 路由器脚本必须存在且可读，否则启动失败并报错：
Failed to open stream: No such file or directory
router.php 必须返回静态文件或手动分发请求
路由器脚本的核心职责是判断当前请求是否对应真实静态文件（如 .css、.js、.png），如果是就用 return false 交还给内置服务器处理；否则自行响应（如解析 $_SERVER['REQUEST_URI'] 后分发到控制器）。
常见漏掉的点：忘记检查文件是否存在，导致所有请求都被当成动态路由，连 index.css 都 500。
立即学习“PHP免费学习笔记（深入）”；
if (file_exists(__DIR__ . $_SERVER['REQUEST_URI'])) {
return false; // 让PHP内置服务器自己输出静态文件
}
// 否则走你的路由逻辑
switch ($_SERVER['REQUEST_URI']) {
case '/':
include 'home.php';
break;
case '/about':
include 'about.php';
break;
default:
http_response_code(404);
echo 'Not Found';
}
注意 $_SERVER['REQUEST_URI'] 包含查询参数，但不含基础路径
内置服务器不会自动剥离子目录前缀。比如你在 /myapp/ 目录下运行 php -S localhost:8000 router.php，访问 http://localhost:8000/myapp/user?id=1 是无效的——因为内置服务器只监听根路径，/myapp/ 这段根本不会出现在 $_SERVER['REQUEST_URI'] 中。
【极品模板】出品的一款功能强大、安全性高、调用简单、扩展灵活的响应式多语言企业网站管理系统。 产品主要功能如下： 01、支持多语言扩展（独立内容表，可一键复制中文版数据） 02、支持一键修改后台路径； 03、杜绝常见弱口令，内置多种参数过滤、有效防范常见XSS； 04、支持文件分片上传功能，实现大文件轻松上传； 05、支持一键获取微信公众号文章（保存文章的图片到本地服务器）； 06、支持一键
换句话说：$_SERVER['REQUEST_URI'] 总是相对于你启动命令时所在的目录，且始终以 / 开头（如 /user?id=1），不反映真实URL中的子路径。
- 无法通过内置服务器模拟生产环境的子目录部署（如
example.com/subdir/） - 如果需要测试带路径前缀的路由，只能在路由器里硬编码过滤，或改用 Nginx + PHP-FPM
-
$_SERVER['SCRIPT_NAME']和$_SERVER['PHP_SELF']在这里不可靠，别依赖
不支持 .htaccess 或任何外部路由配置
有人试图在项目里放 .htaccess 并期望内置服务器识别，这是徒劳的。PHP内置服务器完全忽略该文件，也不读取任何INI级路由规则。所有路由逻辑必须落在 router.php 文件内，且仅执行一次（每次请求都重载该文件）。
这也意味着：无法热更新路由定义而不重启服务器；无法按域名或HTTP方法做条件路由（除非你自己解析 $_SERVER['REQUEST_METHOD']）；也不能设置重定向响应（需手动 header('Location: ...') + exit）。
如果你的项目已依赖 Laravel 的 public/index.php 入口或 Symfony 的前端控制器模式，直接复用它作路由器即可——但要确保它能处理静态资源回退。
