升级ZF2到Laminas后如何解决HelperPluginManager重复声明错误？

问题根源 #

出现的错误是因为laminas-zendframework-bridge组件自动加载时尝试声明Zend\View\HelperPluginManager类，但laminas-view组件中已经存在对应的Laminas\View\HelperPluginManager类，二者命名映射导致类重复声明冲突。

解决方案 #

1. 调整自动加载优先级，优先加载Laminas命名空间 #

在项目根目录的composer.json中修改自动加载规则，确保Laminas命名空间优先被解析：

"autoload": {
    "psr-4": {
        "Laminas\\": "vendor/laminas/",
        "Zend\\": "vendor/laminas/laminas-zendframework-bridge/src/Zend/"
    }
}

执行命令让配置生效：

composer dump-autoload

2. 全局替换项目中Zend命名空间的引用 #

遍历项目代码，将所有Zend\View\HelperPluginManager的引用替换为Laminas\View\HelperPluginManager：

• 控制器/类文件中的use语句：

// 替换前
use Zend\View\HelperPluginManager;

// 替换后
use Laminas\View\HelperPluginManager;

• 配置文件（如module.config.php）：

// 替换前
'view_helper_manager' => [
    'factories' => [
        'customHelper' => Zend\View\Helper\CustomHelperFactory::class,
    ],
],

// 替换后
'view_helper_manager' => [
    'factories' => [
        'customHelper' => Laminas\View\Helper\CustomHelperFactory::class,
    ],
],

3. 禁用laminas-zendframework-bridge的自动映射（可选） #

如果不需要兼容旧Zend命名空间，可以关闭bridge的自动映射功能：
在composer.json中添加额外配置：

"extra": {
    "laminas-zendframework-bridge": {
        "autoload": false
    }
}

执行命令更新组件配置：

composer update laminas/laminas-zendframework-bridge

同时在config/application.config.php中移除Zend模块的注册项（如果存在）：

// 注释或删除该行
'Zend' => true,

4. 修正服务管理器配置 #

在模块的Module.php中，确保视图助手管理器的服务工厂使用Laminas命名空间：

public function getServiceConfig()
{
    return [
        'factories' => [
            Laminas\View\HelperPluginManager::class => function ($sm) {
                $manager = new Laminas\View\HelperPluginManager($sm);
                // 按需添加自定义配置
                return $manager;
            },
        ],
    ];
}

内容的提问来源于stack exchange，提问作者Danny Connolly