摘要：最近把一个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这个框架没有深入的了解，导致这个项目的代码没有一致性，也缺乏统一的计划、架构和规范，没有单元测试。总之，项目的代码质量是不能令人满意的。这些恐怕是大部分业余项目难以避免的问题。
幸好，这个项目不算特别复杂，计有：
通过这些数据可以看出这个项目的规模，应该说是个中小型网站吧。
升级只使用了2个工具，首先是官方的Upgrade Shell，以及DerEuroMark的Upgrade Plugin。
真正动手升级之前我花了一些时间阅读参考资料中列出的文档，实际的升级过程前后总共花了4天时间，不过这里面相当一部分时间用于升级后的测试、以及寻找解决问题的方法。我毕竟从1年前才开始真正使用PHP和CakePHP来开发实际使用的网站，而且只是利用业余时间，所以时间有限，很多东西也都是边做边摸索学习，主要目标是要完成用户需求所要求的功能，来不及了解CakePHP框架的各个方面。如果你有相应的经验，或者有解决下面所涉及问题的这些知识，这个过程会快许多。
首先，确保升级之前，应用程序运行良好，做好代码和数据的备份。如果没有备份，请就此打住！！！
我使用Git(TortoiseGit)做源码控制，这让我可以随时回到过去某一个时间点。数据库使用的是MySQL，升级之前也要做好备份。如果升级过程出了问题，进行不下去，备份让你可以恢复到开始升级之前的状态；如果没有备份，那你可就进退维谷了。
这个项目在升级前的目录结构，如下图所示，
图中，cake为CakePHP 1.3的核心库，app是应用程序代码。
下载最新的CakePHP，我用的是2.5.3，打开压缩包，如下图所示。
图中的lib目录就是CakePHP的核心库，把这个lib目录拷贝到根目录下，然后删除1.3的cake目录，得到如下图所示的目录结构。
图中的lib\Cake目录就是CakePHP 2.x的核心库。
Upgrade Shell是CakePHP核心的一部分，位于lib\Cake\Console\目录下，只需确保能够运行CakePHP Console可执行文件就可以了，这可以参考CakePHP Console的文档。如下图所示，
图中的cake是*nix下的可执行文件，cake.bat是Windows下的可执行文件。我采用的做法，是参考了Upgrade Shell的文档，把lib\Cake\Console\目录拷贝到app目录下，这样只是执行的命令行路径有所不同，结果是一样的，如下图所示。
