composer 安装 mezzio 失败的根本原因是 v4 起已移除 mezzio-skeleton 和 installer 脚本，需先 composer init 初始化项目，再 require mezzio/mezzio 等核心组件，而非使用废弃的 create-project 或 mezzio-tooling。
Composer 安装 Mezzio 时为什么总是失败？
根本原因不是 Mezzio 本身有问题，而是它不接受 composer create-project 直接安装——Mezzio 已在 v4 起移除了内置的 installer 脚本，官方也不再维护 mezzio-skeleton 的独立包。直接运行 composer create-project mezzio/mezzio-skeleton 会报 Could not find package mezzio/mezzio-skeleton 或返回空仓库错误。
正确路径是：先用 Composer 初始化一个空项目，再手动引入 Mezzio 核心组件。这其实是更可控的方式，避免骨架模板强加目录结构或过时依赖。
- 运行
composer init创建composer.json，最低 PHP 版本设为^8.1（Mezzio v4 强制要求） - 执行
composer require mezzio/mezzio mezzio/mezzio-router mezzio/mezzio-handler—— 这三个是运行中间件链的最小依赖 - 别急着装
mezzio/mezzio-skeleton，它已归档，GitHub 页面明确标注DEPRECATED
如何手写最简 PSR-15 中间件并注册到 Mezzio？
Mezzio 的核心就是 MiddlewareInterface，但新手常把 process() 方法签名写错，导致请求卡死或 500 错误。关键不是“怎么写”，而是“怎么让 Mezzio 真正调用它”。
示例中间件：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
use PsrHttpServerMiddlewareInterface;
use PsrHttpServerRequestHandlerInterface;
use PsrHttpMessageResponseInterface;
use PsrHttpMessageServerRequestInterface;
class HelloMiddleware implements MiddlewareInterface
{
public function process(
ServerRequestInterface $request,
RequestHandlerInterface $handler
): ResponseInterface {
$response = $handler->handle($request);
$response->getBody()->write('Hello from Mezzio!');
return $response;
}
}
- 必须实现
MiddlewareInterface，不能只写个闭包——Mezzio v4 默认禁用闭包中间件（需显式启用MezzioContainerImplicitDependenciesConfigProvider） - 注册方式不是改
config/pipeline.php就完事：要确保该类被自动加载，即composer.json中有对应"autoload": {"psr-4": {"App\": "src/"}}，且类文件放在src/HelloMiddleware.php - 若用
FastRouteRouter，路由匹配后才进中间件；若想全局生效，得把它加到config/pipeline.php的最外层MiddlewarePipe中，而非某条路由下
为什么 mezzio-tooling 不推荐用了？
早期教程里频繁出现的 vendor/bin/mezzio 命令行工具，已在 Mezzio v4 中彻底移除。它的替代方案不是另一个 CLI 工具，而是靠标准 PSR-11 容器 + 手动配置。
常见误操作：composer require mezzio/mezzio-tooling —— 这个包早已废弃，安装后会提示 Package mezzio/mezzio-tooling is abandoned，且与当前版本冲突。
- 生成配置文件？直接复制官方
config/autoload/下的示例即可，比如routes.global.php和dependencies.global.php - 添加路由？不再用
mezzio route，而是编辑config/routes.php，用$app->get('/hello', ...)风格（前提是已启用MezzioRouterFastRouteRouter） - 调试容器？用
composer dump-autoload -o后，直接var_dump($container->get('MezzioApplication'))更可靠
PHP 8.2+ 下运行 Mezzio 报 Deprecated: Return type of ... must be compatible 怎么办？
这是最隐蔽的坑：Mezzio v4.9+ 已适配 PHP 8.2，但很多第三方中间件（比如旧版 mezzio-authentication 或自定义日志中间件）仍用 PHP 7 风格声明返回类型，没加 mixed 或 object 占位符，触发 PHP 8.2 的严格类型警告。
- 检查所有中间件类的
process()方法签名，确保返回类型明确为ResponseInterface（不是ResponseInterface|void或留空） - 升级依赖：运行
composer update mezzio/mezzio mezzio/mezzio-router --with-dependencies，强制拉取 v4.9+ 版本 - 若用
laminas-cache或laminas-session，确认它们也升到了支持 PHP 8.2 的版本（如laminas-cache≥ 3.9.0）
真正麻烦的从来不是装上 Mezzio，而是后续每加一个中间件都要核对它的 PHP 版本兼容性声明和返回类型写法——这点文档很少提，但线上环境一开 error_reporting(E_ALL) 就立刻暴露。
