Mezzio 初始化后 composer require laminas 不起作用，因 laminas/laminas 包已废弃，需按需安装具体组件如 laminas/laminas-validator，并手动注册到容器；中间件执行依赖 pipe() 顺序，须在 pipeRoutingMiddleware() 后、pipeDispatchMiddleware() 前注册； hydrator 选型影响 DTO 填充，ClassMethods 调用 setter，Reflection 直接赋值私有属性；prod 环境需确保 config/cache 可写并预生成配置缓存。
Mezzio 项目初始化后为什么 composer require laminas 不起作用
Mezzio 本身是 Laminas 生态的微框架，但默认不预装 Laminas 组件（比如 Laminas\Diactoros、Laminas\Validator），只保留最小依赖。直接 composer require laminas/laminas-validator 是对的，但很多人误以为装个 laminas/laminas 就能“一键全家桶”——这包早已废弃，不存在。
- 必须按需安装具体组件，例如验证用
laminas/laminas-validator，HTTP 消息用laminas/laminas-diactoros - 注意命名空间前缀：所有新包都是
laminas/xxx，不是zendframework/zend-xxx（后者已归档） - 安装后需手动注册到容器（如
ConfigProvider或dependencies.global.php），否则$container->get()会抛NotFoundExceptionInterface
路由匹配了但中间件没执行，常见于 pipe() 和 pipeRoutingMiddleware() 调用顺序
Mezzio 的中间件执行链高度依赖管道顺序。如果把业务中间件写在 pipeRoutingMiddleware() 前面，它会在路由解析前运行，无法访问 $request->getAttribute('route')；反之，如果写在 pipeDispatchMiddleware() 后面，则根本不会被调度。
- 标准顺序应为：
pipe(ErrorHandler::class)→pipe(ServerRequestErrorResponseGenerator::class)→pipeRoutingMiddleware()→pipe(YourAuthMiddleware::class)→pipeDispatchMiddleware() -
pipe()是全局中间件，route()->post('/api/user', ...)定义的是路由级中间件，二者生命周期不同，别混用 - 调试时可临时加
var_dump($request->getAttribute('route') ?: 'no route');确认是否进入路由上下文
用 Laminas\Hydrator 处理 API 输入时，ClassMethods 和 Reflection hydrator 行为差异很大
这两个 hydrator 都支持对象 ↔ 数组转换，但对私有属性、类型提示、构造函数参数的处理完全不同。API 接收 JSON 后常需填充 DTO，选错 hydrator 会导致字段丢失或静默失败。
-
ClassMethods只调用 public setter 方法（如setEmail()），不碰私有属性，也不检查类型；适合有完整 setter 的传统 DTO -
Reflection直接反射赋值私有属性，但要求属性名与键名完全一致，且若 DTO 有__construct(string $name)，必须提前传入，否则报MissingConstructorArgumentsException - 推荐搭配
Laminas\InputFilter先校验再 hydrate，避免把非法数据塞进对象
部署时 prod 环境下 ConfigAggregator 报 Cache not found for key
Mezzio 默认在 prod 模式启用配置缓存，但若 config/cache 目录不可写，或 ConfigAggregator 构造时未传入缓存实例，就会 fallback 到 runtime cache，而该 cache 在 CLI 和 FPM 下隔离，导致反复重建、性能骤降甚至报错。
立即学习“PHP免费学习笔记（深入）”；
- 确保
config/cache目录存在且 web server 用户可写（如chown www-data:www-data config/cache） - 在
config/config.php中显式传入 PSR-16 缓存：new ConfigAggregator([...], 'config/cache/config-cache.php') - CI/CD 部署时务必运行
php bin/console.php config:generate预生成缓存，别依赖首次请求触发
最常被忽略的是缓存路径权限和 CLI/FPM 缓存不共享——这两个点不处理好，API 响应时间可能从 20ms 跳到 800ms。
