ThinkPHP3.2.4迁移到ThinkPHP5.0项目实操教程-ThinkPHP-PHP中文网

thinkphp3.2.4迁移到5.0需重构而非升级：php≥5.6、重搭目录结构、控制器/模型/视图重写、路由显式定义、数据库配置迁移、废弃c()/m()/d()函数，改用验证器、file上传、session/cookie函数及中间件。

thinkphp3.2.4迁移到thinkphp5.0项目实操教程

ThinkPHP3.2.4迁移到ThinkPHP5.0不是版本微调，而是架构重写——两者在目录结构、命名空间、路由机制、数据库操作、模板语法等核心层面几乎完全不兼容。直接复制文件、修改配置基本不可行，必须按模块重构。以下为真实可行的迁移路径，聚焦关键动作和避坑要点。

先停掉旧项目，确认新环境基础

TP5.0要求PHP ≥ 5.6（推荐7.2+），且必须启用mbstring、openssl、pdo扩展。禁用magic_quotes_gpc（PHP 5.4+已移除，但若运行在老旧环境需检查）。不要复用TP3.2的Runtime或Conf目录，TP5.0使用runtime/自动管理缓存与日志，配置统一收口在application/config.php和模块级config.php中。

重搭目录结构，手动迁移业务逻辑

TP5.0标准结构以public/为Web根目录，application/存放应用代码，不再有Lib、Common、Conf等TP3.2式平铺目录。迁移时需：

新建TP5.0项目（推荐用composer create-project topthink/think=5.0）
将TP3.2的控制器类（如Home/IndexController.class.php）重写为application/index/controller/Index.php，类名去掉Controller后缀，继承think\Controller
模型层改用think\Model，原Model基类全部废弃；数据库表字段驼峰转下划线由框架自动处理，无需手动映射
视图文件从View/Home/Index/index.html移至application/index/view/index/index.html，模板引擎默认支持{:U('Index/index')}等写法，但建议改用URL生成函数url('index/index')

重写路由与配置，关闭兼容模式

TP3.2依赖MODULE_NAMEACTION_NAME隐式路由，TP5.0默认关闭该模式，必须显式定义。在application/route.php中补充：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

Route::get('index/:id', 'index/index/read');

数据库配置从Conf/db.php迁移到application/database.php，格式变为数组返回，支持读写分离、多个连接名；原DB_PREFIX改为'prefix' => 'tp_'字段。务必删除所有C()、M()、D()全局函数调用，改用依赖注入或Db::name()、model('User')方式。

替换核心机制，逐项验证功能

常见断裂点及修复方式：

验证规则：TP3.2用array('title','require','标题必须')，TP5.0改用验证器类（application/index/validate/Article.php）或validate(['title'=>'require'])动态验证
上传处理：弃用UploadFile类，改用think\File对象的move()方法，支持本地、云存储驱动
Session/Cookie：不再用S()/C()，改用session('key')或cookie('name')函数，底层可配置驱动（file、redis等）
钩子行为：TP3.2的Hooks被TP5.0中间件（Middleware）和事件系统（Event）替代，登录校验等逻辑应抽离为中间件，在app\middleware.php中注册