摘要：最近把一个CakePHP 1.3的项目升级到了2.x，当然就用最新的版本2.5.3了，结果基本满意。本文记录了升级的过程，包括使用的工具，遇到的问题和相应的解决方法。

这篇文章涉及的内容要求至少有CakePHP中级水平，如果你是刚开始使用CakePHP，建议先不要作这样的尝试，否则遇到问题都不知道怎么解决。

1. 为什么要升级

2. 项目概况

3. 使用的工具

4. 升级的过程

5. 升级之后遇到的问题及解决方法

A. 参考资料

升级到最新版本有很多好处，可以得到最新的更新和功能，可以使用DebugKit这样的调试工具，可以使用View Block方便地把CSS和javaScript放在页面中你希望的地方，而不再痛苦地受限于旧的方式，等等。View Block一直是我最希望使用的特性。

这个项目的开发大致起始于2012年底，我从2013年中开始参与，到2014年中，所有用户要求的功能基本都完成了。我参与了大概1年左右，只是利用业余时间进行。代码一开始是抄自于一个CakePHP 1.3的项目，而没有使用当时最新的2.x版本，这也使得许多开发工作不能利用框架最新的特性和工具，延长了开发周期。可以说，这个项目从开始就做了错误的选择。先后参与的开发人员前后有6个人之多，多数是临时抓来的，大部分人做一段时间之后就会离开，有些功能甚至没有完成就走人了。而且大家对CakePHP这个框架没有深入的了解，导致这个项目的代码没有一致性，也缺乏统一的计划、架构和规范，没有单元测试。总之，项目的代码质量是不能令人满意的。这些恐怕是大部分业余项目难以避免的问题。

幸好，这个项目不算特别复杂，计有：

• 数据库有36张表
• 19个控制器(Controller)
• 33个模型(Model)
• 63个视图(View)
• 2个插件(Plugin)
• 当然还有其他一些东西

通过这些数据可以看出这个项目的规模，应该说是个中小型网站吧。

升级只使用了2个工具，首先是官方的Upgrade Shell，以及DerEuroMark的Upgrade Plugin。

真正动手升级之前我花了一些时间阅读参考资料中列出的文档，实际的升级过程前后总共花了4天时间，不过这里面相当一部分时间用于升级后的测试、以及寻找解决问题的方法。我毕竟从1年前才开始真正使用PHP和CakePHP来开发实际使用的网站，而且只是利用业余时间，所以时间有限，很多东西也都是边做边摸索学习，主要目标是要完成用户需求所要求的功能，来不及了解CakePHP框架的各个方面。如果你有相应的经验，或者有解决下面所涉及问题的这些知识，这个过程会快许多。

首先，确保升级之前，应用程序运行良好，做好代码和数据的备份。如果没有备份，请就此打住！！！

我使用Git(TortoiseGit)做源码控制，这让我可以随时回到过去某一个时间点。数据库使用的是MySQL，升级之前也要做好备份。如果升级过程出了问题，进行不下去，备份让你可以恢复到开始升级之前的状态；如果没有备份，那你可就进退维谷了。

这个项目在升级前的目录结构，如下图所示，

图中，cake为CakePHP 1.3的核心库，app是应用程序代码。

下载最新的CakePHP，我用的是2.5.3，打开压缩包，如下图所示。