PHP内置服务器如何设置路由支持

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。

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'] 中。

换句话说：$_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 的前端控制器模式，直接复用它作路由器即可——但要确保它能处理静态资源回退。