Composer不安装单体框架,而是按需拉取Laminas独立组件;官方推荐Mezzio(PSR-15微框架)或laminas-mvc组件组合,废弃laminas/laminas包及laminas-tool。
Composer 本身不“安装框架”,而是通过它拉取 Laminas 的组件包;Laminas 已不再维护单体框架,官方推荐按需组合
、
等独立组件,或直接使用
/
(后者是现代 PSR-15 微服务方案)。
用
composer
create-project 初始化 Mezzio(Laminas 官方推荐的现代替代)
Mezzio 是 Laminas 社区当前主推的 PSR-15 兼容微框架,比旧版
更轻、更灵活,且持续更新。直接创建项目比手动 require 组件更可靠:
执行时会交互选择:容器(Pimple / laminas-servicemanager / PHP-DI)、模板引擎(Plates / Twig / None)、HTTP 客户端等。选完即生成可运行结构。
常见卡点:
PHP 版本必须 ≥ 8.0(Mezzio 4+ 不支持 7.x)
若提示
,是 Composer 缓存损坏,运行
后重试
国内用户常因 Packagist 镜像未同步导致
找不到,临时切回官方源:
手动 require laminas-mvc(仅限遗留项目迁移)
如果你必须复用旧 MVC 结构(如从 Zend Framework 2/3 升级),不要装
(该包已废弃且为空),而是明确引入核心组件:
注意:
Docker Sandbox
创建并管理 Docker 沙箱虚拟机环境以安全执行代理。适用于运行不受信任代码、探索包或隔离代理工作负载。支持 Claude、Codex、Copilot、Gemini 和 Kiro 代理,并提供网络代理控制。
下载
默认不带命令行工具,需额外加
启用开发模式
入口文件
必须显式调用
,不能只 include
(该文件在 Laminas 中已移除)
模块配置必须放在
,且返回数组,不能用旧的
方式
vendor/autoload.
php
加载失败或类找不到?检查 autoloader 生成逻辑
Laminas 组件严格依赖 Composer 的 PSR-4 自动加载,但部分组件(如
)同时提供
和
。若运行时报
:
确认
后
存在且被入口文件正确 require
检查
中是否误删了
段(Mezzio 脚手架默认有,手动建项目易遗漏)
运行
强制优化加载器,避免开发环境因文件变动未刷新映射
若用 Docker,确保
目录没被 .
docker
ignore 排除,且容器内 PHP 版本与宿主机一致
为什么不用 composer global install laminas-tool?
已于 2020 年归档,不再维护。其功能(生成控制器、模块等)已被 Mezzio 的
取代:
之后可用:
关键区别:
生成的是 PSR-15 中间件,不是 MVC 的 Controller
所有生成命令基于当前项目的配置(如容器类型),不会硬
编码
依赖
不修改全局 Composer 环境,避免不同项目 PHP 版本冲突
真正容易被忽略的是:Laminas 生态已彻底转向“组件化 + PSR 标准”,任何试图复刻 Zend Framework 2 时代单体框架行为的操作,都会在依赖解析、生命周期管理或测试集成上遇到隐性阻力。
laminas-mvclaminas-httplaminas-api-toolsmezziolaminas-mvccomposer create-project mezzio/mezzio-skeleton my-laminas-appzlib_decode(): data errorcomposer clear-cachemezzio-skeletoncomposer config -g repo.packagist composer https://packagist.orglaminas/laminascomposer require laminas/laminas-mvc \
laminas/laminas-servicemanager \
laminas/laminas-router \
laminas/laminas-http \
laminas/laminas-viewlaminas-mvclaminas/laminas-development-modepublic/index.phpLaminas\Mvc\Application::init()init_autoloader.phpconfig/modules.config.phpreturn new Module();laminas-configclassmappsr-4Class not foundcomposer installvendor/autoload.phpcomposer.json"autoload": {"psr-4": {...}}composer dump-autoload -ovendor/laminas-toolmezzio-clicomposer require --dev mezzio/mezzio-cli./vendor/bin/mezzio generate:handler PingHandlermezzio-cli