如何逐步将CakePHP 2.0升级至CakePHP 3及CakePHP 4？

从 CakePHP 2.x 升级到 3.x #

CakePHP 3.x 是架构重写版本，与 2.x 差异极大，确实需要大量代码调整，但可通过模块化分步迁移降低复杂度：

• 环境前置检查：确保服务器满足要求：PHP 5.4.16+（推荐 7.0+），启用 mbstring、intl 扩展，数据库支持 PDO。
• 搭建全新 3.x 项目骨架：通过 Composer 创建标准项目：

  composer create-project --prefer-dist cakephp/app:^3.9 my_cake3_app
  

• 分模块迁移核心代码：
  • 配置文件：将 2.x Config/ 下的配置迁移至 3.x config/，注意 3.x 采用数组配置而非 PHP 类，例如数据库配置从 database.php 转为 config/app.php 中的 Datasources 数组。
  • 模型层：2.x 的 Model 类需拆分为 3.x 的 Table 与 Entity 模式：原 User.php 模型拆分为 src/Model/Table/UsersTable.php（处理数据库交互、关联关系）和 src/Model/Entity/User.php（定义实体属性）；关联关系写法调整为在 Table 类中通过 $this->belongsTo('Users') 这类方法定义。
  • 控制器层：AppController 继承关系改为 App\Controller\AppController；请求数据获取从 $this->request->data 改为 $this->request->getData()；验证规则、分页逻辑需移至对应 Table 类的 validationDefault() 等方法中。
  • 视图层：.ctp 模板可逐步迁移，注意助手方法参数变化，例如 HtmlHelper::link() 参数顺序调整、FormHelper::create() 参数结构更新。
• 用升级工具减少重复工作：安装官方升级工具自动处理命名空间、类名等通用修改：

  composer require --dev cakephp/upgrade
  bin/cake upgrade rector src/
  

• 迭代测试：每迁移完成一个模块，立即运行单元测试与功能测试，确保功能正常后再推进下一部分。

从 CakePHP 3.x 升级到 4.x #

4.x 是 3.x 的迭代优化版本，改动以废弃 API 移除、PHP 版本要求提升为主，迁移成本低：

• 环境检查：必须使用 PHP 7.2+（推荐 7.4+ 或 8.0+）。
• 更新依赖：通过 Composer 升级核心框架及插件：

  composer require cakephp/cakephp:^4.4
  

  同时确保所有第三方插件更新至支持 4.x 的版本。
• 代码适配：
  • 替换废弃 API：例如将 $this->request->query 改为 $this->request->getQuery()，移除 Collection 类中的废弃方法。
  • 调整命名空间：部分核心类命名空间变更，例如 Cake\Network\Request 改为 Cake\Http\Request。
  • 视图适配：若使用 Twig 模板，需更新 TwigView 插件至兼容版本；原生 CTP 模板改动极小，仅需替换少量废弃助手方法。
• 验证测试：运行全量测试，排查并修复日志中的废弃警告，确保功能无异常。

关于“需修改全部文件”的说明 #

CakePHP 3.x 相对于 2.x 是彻底的架构重写，从命名空间、MVC 层的实现逻辑到核心 API 都有根本性变化，因此确实需要大量代码调整。但通过模块化分步迁移+官方升级工具辅助，可将工作量拆解为小任务，避免一次性修改所有文件带来的混乱，降低迁移难度。

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