ThinkPHP 3.2 升级到 5.1 是架构级迁移，需重写目录结构、命名空间、路由规则、模板语法及数据库操作逻辑，并清除缓存以避免兼容性问题。
ThinkPHP 3.2 升级到 5.1 不是简单替换文件，而是架构级迁移。核心冲突集中在目录结构、命名空间、路由机制、模板解析和底层调用方式上。很多报错看似随机，实则有固定模式——只要按顺序排查，90% 的问题都能快速定位。
目录与类文件结构必须重写
TP3.2 的 Controller/Model/View 目录规则在 TP5.1 中完全失效，不调整会导致类找不到、模板无法加载。
- 控制器和模型文件名要去掉
.class.php后缀：如UserController.class.php→User.php - 所有 PHP 文件需统一小写（
Uploads目录除外），否则 Windows 开发环境可能正常，Linux 生产环境直接 500 - 视图目录从
View/default/改为view/，去掉default这一层；同时把Public/改为publics/（避免与系统保留字Public冲突） - 命名空间必须重写：
namespace Admin\Controller;→namespace app\admin\controller;，且类定义中去掉Controller后缀：class UserController extends Controller→class User extends BaseController
路由和 URL 访问方式彻底失效
TP3.2 的 ?m=Home&c=Index&a=index 模式在 TP5.1 中被完全抛弃，硬套旧链接必 404。
- 删除 Conf/config.php 中所有以
URL_开头的配置（如URL_MODEL），这些字段已废弃，保留会干扰路由解析 - 新建
route/app.php，用Route::rule()或Route::resource()重新定义路由，例如：Route::rule('user/profile/:id', 'index/User/profile'); - 确保
config/app.php中'with_route' => true（默认开启，但常被误关） - 原 TP3.2 的模块名（如
Home、Admin）不再自动识别，访问路径变成/user/profile/123，不是/index.php?m=Home&c=User&a=profile
模板引擎解析规则收紧，老写法静默失败
TP5.1 模板编译器更严格，很多 TP3.2 能“蒙混过关”的写法会直接跳过或报错。
立即学习“PHP免费学习笔记（深入）”；
- 升级后第一件事：清空
runtime/Cache和runtime/Temp全部内容——缓存残留导致 80% 的模板异常 -
{volist}标签只认name和key（全小写），index、ID、KEY都无效；嵌套时内外层 name 不能重复，否则数据覆盖 - 禁止在模板中使用
{php}、{present}、{empty}旧语法，改用{if empty($list)}或{foreach $list as $v} - HTML 注释
<!-- -->包裹模板标签会中断解析，必须删掉
数据库操作与变量赋值逻辑变更
TP5.1 强制显式控制数据行为，隐式操作（如未声明就 save）会出错或逻辑偏移。
-
M('user')->save($data)必须明确区分新增或更新：->insert($data)或->isUpdate(true)->update($data) - 模板中未
assign的变量（如{$name}）在开发环境触发 Notice，在线上可能输出空字符串，必须在控制器中显式赋值：$this->assign('name', $user['name'] ?? ''); - 系统变量如
{$Think.get.id}仍可用，但推荐改用{$Think.get.id ?? '未传'}，更稳定 - 禁止在模板里执行查询或调用模型方法，所有数据处理必须前置到控制器完成
