laminas-zendframework-bridge是专为旧zend项目迁移设计的运行时别名工具，通过自动加载器将zend\类映射为laminas\类，支持zf2/3、apigility、expressive；新项目应直接使用mezzio-skeleton或laminas-mvc-skeleton骨架，而非安装废弃的zendframework/zendframework或空壳laminas/laminas包。
Composer 不安装 Zend 框架，也不“安装 Laminas 框架”——它只拉取具体组件，而 Laminas 已无单体框架包。 你看到的 laminas/laminas 是个空壳包，早已废弃；zendframework/zendframework 在 Packagist 上彻底下线，硬装会触发依赖冲突或 Class not found。真正可行的路径只有两条：用 laminas-zendframework-bridge 迁移旧项目，或直接初始化 Mezzio / laminas-mvc-skeleton 等现代骨架。
为什么 composer create-project zendframework/zendframework 一定失败
这不是网络或缓存问题，是根本性废弃：
-
zendframework/zendframework包在 2019 年后从 Packagist 移除，Composer 会直接报Could not find package - 即使通过历史镜像或
composer install --ignore-platform-reqs强行装上 v3.x，也会因 PHP 8+ 不兼容、zend-servicemanagerv2/v3 混用导致Class 'Zend\Mvc\Application' not found - 所有类名空间（
Zend\→Laminas\）、配置键（service_manager→dependencies）、事件名（bootstrap→application.bootstrap）全部变更，不改代码就跑不起来
旧 Zend Framework 2/3 项目怎么用 Composer 接入 Laminas 生态
核心工具是 laminas-zendframework-bridge，它不是升级脚本，而是运行时别名层：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 执行
composer require laminas/laminas-zendframework-bridge，安装后自动注册 Autoloader，无需改入口文件 - 它把
Zend\Router、Zend\Validator、Zend\Paginator等全部映射到对应Laminas\类，连ZF\Apigility→Laminas\ApiTools、Zend\Expressive→Mezzio都覆盖 - 若第三方库里有硬编码的
Zend\类名，可编辑config/replacements.php手动加映射，例如：'MyLegacy\ZendExt'→'MyLegacy\LaminasExt' - 注意：该桥接器已进入安全维护模式，仅修高危漏洞，不新增功能，适合存量系统过渡，非新项目首选
新项目该用什么 Composer 命令初始化
跳过桥接，直选官方推荐骨架：
- 微服务/API 优先：运行
composer create-project mezzio/mezzio-skeleton my-app（要求 PHP ≥ 8.0），交互选择容器（PHP-DI推荐）、模板引擎（None可选）等，生成即跑 - MVC 风格传统结构：用
composer create-project laminas/laminas-mvc-skeleton my-app（PHP 7.4+ 兼容，但建议 8.1+），它比旧 ZF3 更轻，模块配置必须放在config/modules.config.php且返回数组，不能写return new Module() - 切勿手动
composer require laminas/laminas-mvc后自己拼骨架——缺少路由、错误处理、开发模式等关键 glue code，public/index.php会因漏调Laminas\Mvc\Application::init()直接白屏
vendor/autoload.php 加载失败或类找不到的排查重点
这不是 Composer 没装好，而是 Laminas 组件对自动加载规则极其敏感：
- 确认入口文件（如
public/index.php）第一行是require __DIR__ . '/../vendor/autoload.php';，且路径正确 -
laminas-config等组件同时提供psr-4和classmap，若执行过composer dump-autoload --optimize后出错，先删vendor/composer/autoload_classmap.php再重试 - 开发服务器用
php -S启动时，OPcache 必须关闭或设opcache.validate_timestamps=1，否则改了配置不生效，始终报旧类名未定义 - 国内用户若
create-project卡在 “mezzio-skeleton not found”，临时切回官方源：composer config -g repo.packagist composer https://packagist.org
真正卡住人的从来不是命令输错，而是以为“装完就能跑”——Laminas 组件之间没有隐式绑定，每个 require 都得明确，每个配置键都得对齐，每个命名空间迁移都得扫干净。桥接器能省事，但扫不到的遗留引用，最终还得 grep 出来一行行改。
