CakePHP 2.10升级至3.x操作流程及相关问题咨询
CakePHP 2.10 升级至 3.x 问题解答
- 是否有公开的完整升级步骤指南?
有官方的完整迁移步骤,核心流程可参考3.x版本文档的迁移专项章节,通用标准步骤为:先完成项目全量备份、确认环境满足3.x最低要求(PHP 5.6及以上)、安装官方升级工具、先运行目录结构生成命令、再运行代码重构命令、手动调整不兼容的业务逻辑、逐个修复运行时报错、完成全量功能测试。
- 是否有公开的完整升级步骤指南?
- 执行
composer require cakephp/cakephp:^3.0更新版本是否正确?该在迁移工具运行前还是后执行?
这个操作是正确的,但执行前需要先清理composer.json中旧的2.x版本相关依赖声明,避免依赖冲突。操作顺序必须是运行完所有升级工具命令后再执行该操作,升级工具需要在原有2.10版本的正常运行环境下执行,才能正确识别旧代码结构,提前升级核心包会导致项目环境崩溃,升级工具无法正常运行。
- 执行
- 是否需要优先运行
bin/cake upgrade skeleton命令?
需要,且必须在其他升级命令前优先执行该命令。该命令会生成3.x版本标准的目录结构,包括/src、/webroot、/config等核心目录的基础框架文件,如果跳过该命令直接运行upgrade all,工具生成的3.x格式代码会存入错误路径,后续还需要手动迁移调整,反而增加工作量。
- 是否需要优先运行
- 升级完成后是否需要清理旧目录结构?
需要清理,在所有功能测试验证通过、确认项目运行正常后,需要删除2.x版本的旧目录及文件,包括/app下的Controller、Model、View、Config目录,还有根目录下的旧入口文件、旧版cli脚本,避免新旧代码加载冲突。清理前建议再做一次全量备份,防止需要回滚调整。
- 升级完成后是否需要清理旧目录结构?
内容的提问来源于stack exchange,提问作者Aris
相关产品推荐
相关产品推荐

