php 8.6接入fastroute时,先匹配http方法与路径,再按not_found、method_not_allowed和found分别响应。路径存在但方法不符应返回405及allow头;把它统一当作404,会让调用方难以识别真正的请求契约。

官方文档:Usage
固定版本并设置前端入口
安装nikic/fast-route:^1.3,以下使用稳定1.3.1的RouteCollector接口。让站点服务器把目标请求交给同一个PHP入口,保留原REQUEST_URI;示例只接受数字编号,不把路由匹配当作登录或资源访问授权。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。

官方文档:Dispatching a URI
明确处理三个分派结果
<?php
require __DIR__ . '/vendor/autoload.php';
$d = FastRoute\simpleDispatcher(function (FastRoute\RouteCollector $r) {
$r->addRoute('GET', '/items/{id:\d+}', 'item');
});
$path = explode('?', $_SERVER['REQUEST_URI'] ?? '/', 2)[0];
$info = $d->dispatch($_SERVER['REQUEST_METHOD'] ?? 'GET', rawurldecode($path));
header('Content-Type: application/json; charset=utf-8');
switch ($info[0]) {
case FastRoute\Dispatcher::NOT_FOUND:
http_response_code(404); echo '{"error":"not_found"}'; break;
case FastRoute\Dispatcher::METHOD_NOT_ALLOWED:
http_response_code(405);
header('Allow: ' . implode(', ', $info[1]));
echo '{"error":"method_not_allowed"}'; break;
case FastRoute\Dispatcher::FOUND:
$id = filter_var($info[2]['id'], FILTER_VALIDATE_INT, ['options' => ['min_range' => 1]]);
if ($id === false) { http_response_code(400); echo '{"error":"invalid_id"}'; break; }
echo json_encode(['id' => $id], JSON_THROW_ON_ERROR); break;
}分别测试路径和方法
GET /items/42应进入匹配分支;POST /items/42应返回405并包含GET允许方法;GET /missing应返回404。最后的FOUND示例仅返回已校验编号,实际读取资源时还需要鉴权与不存在处理。FastRoute对HEAD有回退匹配行为,生产接口还需在响应层遵守HEAD不返回正文的要求。


















