从Zend Framework 3迁移到Laminas后LaminasStorageCache服务创建失败

错误信息 #

无法创建名为“DoctrineModule\Cache\LaminasStorageCache”的服务。原因：无法解析DoctrineModule\Cache\LaminasStorageCache类中类型为Laminas\Cache\Storage\StorageInterface的“storage”参数（请求为DoctrineModule\Cache\LaminasStorageCache）

问题场景 #

从Zend Framework 3迁移到Laminas后，执行数据库访问代码时触发上述错误：

$this->getServiceLocator()->get('Doctrine\ORM\EntityManager');

能够正常获取ServiceLocator实例，但无法实例化EntityManager，问题根源在于Laminas的DI容器在创建LaminasStorageCache时，找不到必填的storage参数值。

现有Doctrine数据库配置 #

'doctrine' => array(
        'connection' => array(
            'orm_default' => array(
                'driverClass' => \Doctrine\DBAL\Driver\PDO\MySQL\Driver::class,
                'params' => array(
                    'host'     => 'localhost',
                    'port'     => '3306',
                    'user'     => 'root',
                    'password' => '',
                    'dbname'   => 'mybase',
                    'charset'  => 'utf8'
                )
            )
        ),

已尝试操作 #

• 手动配置Doctrine缓存，但无效果
• 对比同环境下成功迁移的项目，配置无差异，但问题依然存在

解决方案 #

1. 验证DoctrineModule版本兼容性
   检查当前安装的DoctrineModule版本，确保适配Laminas环境。执行命令查看版本：

   composer show doctrine/doctrine-module
   

   ZF3时期的旧版本可能存在DI配置逻辑差异，建议升级到3.x系列的稳定版。

2. 补充Doctrine缓存配置
   Laminas环境下，DoctrineModule需要明确的缓存存储配置才能自动解析storage参数。在现有doctrine配置中添加缓存节点：

   'doctrine' => array(
       // 保留原有connection配置
       'cache' => array(
           'orm_default' => array(
               'driver' => 'array', // 可根据需求替换为filesystem、redis等适配器
               'namespace' => 'doctrine_cache',
           ),
       ),
   ),
   

   或者直接在服务管理器中手动配置LaminasStorageCache的工厂：

   'service_manager' => array(
       'factories' => array(
           'DoctrineModule\Cache\LaminasStorageCache' => function ($sm) {
               // 这里使用Array适配器作为示例，可替换为其他存储适配器
               $storage = $sm->get('Laminas\Cache\Storage\Adapter\Array');
               return new \DoctrineModule\Cache\LaminasStorageCache($storage);
           },
       ),
   ),
   

3. 检查模块加载顺序
   确保DoctrineModule和DoctrineORMModule在modules.config.php中排在自定义模块之前，保证DI容器优先加载Doctrine的服务配置，避免依赖解析顺序错误。

4. 清理缓存

   • 清空Laminas项目的缓存目录（通常为data/cache/）
   • 执行composer dump-autoload更新自动加载缓存，避免旧的ZF3缓存文件干扰

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