PHP内置服务器不支持重写，必须手动指定router.php路由脚本；该脚本需检查静态文件存在性并返回false交由服务器处理，否则自行分发请求，且无法模拟子目录部署或识别.htaccess。
PHP内置服务器默认不支持重写，必须手动指定
路由器
脚本
PHP内置服务器（
）本身没有Apache或Nginx那样的URL重写能力。它只做静态文件服务和简单路由分发，所有动态请求（比如
或
）都必须由你提供的路由器脚本统一接管——否则直接返回404。
这意味着：你不能靠配置文件开启“路由支持”，必须显式传入一个
路由器文件作为第三个参数。
正确启动方式：
错误做法：
（没路由器，深层路径全404）
路由器脚本必须存在且可读，否则启动失败并报错：
router.
php
必须返回静态文件或手动分发请求
路由器脚本的核心职责是判断当前请求是否对应真实静态文件（如
、
、
），如果是就用
交还给内置服务器处理；否则自行响应（如解析
后分发到控制器）。
常见漏掉的点：忘记检查文件是否存在，导致所有请求都被当成动态路由，连
都 500。
立即学习
“
PHP免费学习笔记（深入）
”；
注意 $_SERVER['REQUEST_URI'] 包含查询参数，但不含基础路径
内置服务器不会自动剥离子目录前缀。比如你在
目录下运行
，访问
是无效的——因为内置服务器只监听根路径，
这段根本不会出现在
中。
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
换句话说：
总是相对于你启动命令时所在的目录，且始终以
开头（如
），不反映真实URL中的子路径。
无法通过内置服务器模拟生产环境的子目录部署（如
）
如果需要测试带路径前缀的路由，只能在路由器里硬
编码
过滤，或改用 Nginx + PHP-FPM
和
在这里不可靠，别依赖
不支持 .ht
access
或任何外部路由配置
有人试图在项目里放
并期望内置服务器识别，这是徒劳的。PHP内置服务器完全忽略该文件，也不读取任何INI级路由规则。所有路由逻辑必须落在
文件内，且仅执行一次（每次请求都重载该文件）。
这也意味着：无法热更新路由定义而不重启服务器；无法按域名或HTTP方法做条件路由（除非你自己解析
）；也不能设置重定向响应（需手动
+
）。
如果你的项目已依赖 Laravel 的
入口或 Symfony 的
前端
控制器模式，直接复用它作路由器即可——但要确保它能处理静态资源回退。
php -S/user/123/api/posts.phpphp -S localhost:8000 router.phpphp -S localhost:8000Failed to open stream: No such file or directory.css.js.pngreturn false$_SERVER['REQUEST_URI']index.cssif (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';
}/myapp/php -S localhost:8000 router.phphttp://localhost:8000/myapp/user?id=1/myapp/$_SERVER['REQUEST_URI']$_SERVER['REQUEST_URI']//user?id=1example.com/subdir/$_SERVER['SCRIPT_NAME']$_SERVER['PHP_SELF'].htaccessrouter.php$_SERVER['REQUEST_METHOD']header('Location: ...')exitpublic/index.php