thinkphp 3.2 在 3.1 的基础上进行了大规模重构，其变更程度之深，几乎可视为一次版本代际升级，甚至足以命名为 thinkphp 4.0，而非一次常规的版本迭代。因此，若现有项目基于 thinkphp 3.1 构建，切勿贸然进行升级操作——这远非简单的文件替换所能完成。由于底层架构与运行机制的多处调整，升级过程极易引发兼容性问题，导致系统运行异常。本文将全面梳理 3.2 版本的核心改动，并重点提示迁移过程中必须关注的关键事项，助力开发者顺利完成版本过渡。
PHP 版本的演进历程
从版本依赖来看，ThinkPHP 3.2 要求 PHP 5.3 或更高版本才能正常运行，而 3.1 版本仅需 PHP 5.2 即可支持。这一变化意味着升级前必须确保服务器环境满足新版本的 PHP 版本要求，否则将无法启动应用。
程序目录结构的调整
立即学习“PHP免费学习笔记（深入）”；
在目录命名方面，ThinkPHP 3.2 将核心应用目录由原先的 app 更名为 Application，取代了 3.1 版本中的命名方式，标志着项目结构的一次规范化升级。
针对不同分组模式的升级优化策略
建议后续开发中尽量减少对模块分组的依赖，因其在新版本中已逐渐弱化，容易带来配置和路由上的复杂问题。本文主要围绕无分组情况下的迁移方案展开说明；若项目涉及分组结构，开发者可结合官方文档自行探索适配方法。
新增 Home 模块目录
3.2 版本引入了默认的 Home 目录，用于存放前端相关模块文件，多数原位于根应用目录下的内容需迁移至 Application/Home/ 下统一管理。
例如，原路径 App/Common/extend.php 需调整为 Application/Home/Common/extend.php（前提是该文件存在并被引用）。
语言包文件也需迁移：将 App/Lang/zh-cn/common.php 移动至 Application/Home/Lang/zh-cn.php（若原路径存在对应语言文件）。
由于新增了 Home 模块目录，原有的 .htaccess 重写规则也需同步更新，避免因路径不匹配导致访问错误。
否则可能出现“无法找到模块”的运行时异常。
MVC 结构命名规范化
新版将原本的 Action 和 Tpl 文件夹分别重命名为 Controller 和 View，使 MVC 层级划分更加清晰明确。此举提升了代码结构的可读性与维护性。若希望保留 Action 命名习惯，可通过修改 Application/Common/config.php 中的相关配置项实现兼容，从而平稳过渡的同时享受新命名带来的规范优势。
默认控制器层名称设为 Action，用于指定系统默认调用的控制类层级。
通过 MODULE_ALLOW_LIST => array('Index', 'Admin', ...) 可定义允许访问的模块列表，适配原有分组结构。
初始模块默认设置为 Home，即调整默认入口模块指向。
系统配置参数更新
部分在 3.1 中使用的系统配置参数在 3.2 中已被废弃，需根据新版本要求重新调整配置内容。
相关配置项已作出相应变更，开发者应逐一核对并更新。
命名空间的引入
ThinkPHP 3.2 正式引入命名空间机制，提升代码组织能力。为此，需在 Application/Home/Controller 目录下所有类文件的顶部（注释之后的第一行）添加命名空间声明语句，以确保类能被正确加载和调用。
若项目使用了控制器分层（如 Event 层），则对应类文件也需在头部加入相应的命名空间定义。
同理，在 Application/Home/Model 目录下的所有模型文件首行（除注释外）也需添加命名空间声明。
若采用模型分层架构（如 Service 层），各层类库文件均需补充对应的命名空间声明，例如在 Service 类中加入 namespace Home\Service; 等内容。
优化方法调用方式
部分在 ThinkController 或 ThinkAction 基类中定义的方法已在 3.2 版本中被标记为废弃，不再推荐使用。
摒弃旧有方式，推行更高效、更规范的新机制，以实现系统的持续优化与现代化演进。
常量使用调整
以下常量在新版本中已被移除或不再建议使用：
在 3.2 版本中，某些常量已无需手动定义，系统将自动处理其对应功能。
可使用 __MODULE__ 表示当前模块的 URL 路径，__GROUP__ 同样可用于路由配置中。
通过 MODULE_NAME 获取当前模块名称，替代原先的 GROUP_NAME 方式，实现更准确的模块识别与动态调用。
此外，3.2 版本已停用“模式扩展”功能，请参考新版文档中的模式调整说明进行相应配置变更。
至此，主要迁移工作基本完成。若在升级过程中遇到其他个性化问题，可根据实际情况查找对应解决方案。
