Mezzio项目初始化后public/index.php报“Class Mezzio\Application not found”是因Composer自动加载未生效，需执行composer install并确认vendor/autoload.php存在；删vendor/和composer.lock后重装可解决。
Mezzio 项目初始化后为什么 public/index.php 报错 “Class Mezzio\Application not found”
这是 Composer 自动加载没生效的典型表现，不是 Mezzio 本身有问题。新项目跑不起来，90% 是因为没执行安装步骤或 autoloader 没重建。
- 确认已运行
composer install（不是composer update），且无报错 - 检查
vendor/autoload.php是否真实存在；如果被 .gitignore 忽略又没重新装，就会找不到类 - 删掉整个
vendor/和composer.lock，再跑一遍composer install --no-dev（尤其在 CI 或 Docker 环境里） - 别手动改
public/index.php的 require 路径——它依赖 Composer 生成的 autoload 机制，硬编码路径只会让问题更隐蔽
注册 PSR-15 中间件时，$app->pipe() 和 $app->pipeRoutingMiddleware() 有什么区别
这两个不是“可互换的写法”，而是职责完全不同：一个挂载通用中间件，一个只负责路由解析前的预处理。
-
$app->pipe()：所有请求都会经过，比如日志、CORS、body 解析。它在路由匹配之前和之后都执行（取决于你放的位置） -
$app->pipeRoutingMiddleware()：仅用于把路由信息注入到请求中（比如RouteResult），必须放在pipeRoutingMiddleware()之后才能用$request->getAttribute('route') - 常见错误：把鉴权中间件写成
pipeRoutingMiddleware()——它不会自动获得路由参数，也拦不住未匹配路由 - 正确顺序通常是：
pipe()（body 解析）→pipeRoutingMiddleware()→pipeDispatchMiddleware()→pipe()（鉴权/日志等）
用 Mezzio\Router\FastRouteRouter 时，为什么带变量的路由（如 /user/{id}）总 404
FastRoute 默认不开启占位符解析，需要显式配置参数约束，否则它把 {id} 当字面量字符串匹配。
- 定义路由时不能只写
$router->addRoute('GET', '/user/{id}', ...)，得加上约束：$router->addRoute('GET', '/user/{id:\d+}', ...) - 如果要用非数字 ID（比如 UUID），约束得写成
{id:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}} - 别指望
Mezzio\Router\RouteCollector的快捷方法（如get()）自动帮你加约束——它们只是语法糖，底层还是靠 FastRoute 的 pattern - 调试技巧：在中间件里 dump
$request->getUri()->getPath()和$request->getAttribute('route')，看是否为空
在中间件里获取路由参数，为什么 $request->getAttribute('id') 返回 null
Mezzio 不会自动把路由占位符映射为 request attribute，得靠 Mezzio\Router\Middleware\DispatchMiddleware 或手动提取。
立即学习“PHP免费学习笔记（深入）”；
- 确保已调用
$app->pipeDispatchMiddleware()（通常在pipeRoutingMiddleware()之后） - 参数默认存放在
RouteResult对象里，要这样取：$routeResult = $request->getAttribute(RouteResult::class); $id = $routeResult?->getMatchedParams()['id'] ?? null; - 别直接用
$request->getAttribute('id')——除非你自己写了中间件把它 set 进去，否则这个 key 不存在 - 如果用了
Mezzio\Handler\NotFoundHandler，注意它可能在 dispatch 前就返回了 404，导致你的参数提取逻辑根本没机会执行
PSR-15 的中间件链是线性的，但 Mezzio 的路由生命周期有明确阶段划分。漏掉一个 pipe* 调用，或者把中间件挂错位置，参数就断在半路。调试时优先看 RouteResult 是否存在，而不是猜 attribute 名。
