升级Zend Framework 3后注册页prg插件未找到错误如何解决

报错原因 #

Zend Framework 3对核心组件做了轻量化拆分，原ZF2版本中内置的prg（Post/Redirect/Get）控制器插件被剥离为独立组件，不再随zend-mvc核心包默认安装。如果升级过程中未额外安装该独立组件，或者组件未在项目配置中完成注册，就会触发插件未找到的异常。

排查解决步骤 #

• 第一步：安装对应独立组件
  执行composer命令安装官方PRG插件包：

  composer require zendframework/zend-mvc-plugin-prg
  

  若项目已经迁移到Laminas（Zend Framework后续社区分支），则执行以下命令：

  composer require laminas/laminas-mvc-plugin-prg
  

• 第二步：验证组件注册配置
  打开项目根目录下的config/modules.config.php，确认配置数组中已添加Zend\Mvc\Plugin\Prg（Laminas版本对应为Laminas\Mvc\Plugin\Prg），未添加的话手动写入配置数组即可。
• 第三步：清理配置缓存
  如果项目开启了配置缓存，删除data/cache目录下的所有模块配置缓存文件，重启应用后验证功能是否恢复正常。
• 异常场景补充：如果完成上述步骤仍报错，检查全局控制器插件配置中是否存在prg别名的异常覆盖配置，正常情况下组件注册完成后会自动注册prg别名，无需手动额外配置。

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