ThinkPHP53.2如何升级5_ThinkPHP5从3.2升级迁移指南【升级】-ThinkPHP-PHP中文网

thinkphp 3.2 升级到 5.x 是跨代重构，需新建项目、重写目录结构与命名空间、迁移配置与路由、替换数据库与模板调用方式，并适配缓存、上传、url 生成等全部基础功能。

thinkphp53.2如何升级5_thinkphp5从3.2升级迁移指南【升级】

ThinkPHP 3.2 升级到 5.x 不是“小版本更新”，而是跨代重构——目录结构、路由机制、数据库层、模板引擎、自动加载全部重写，直接改 composer.json 或覆盖文件必然失败。

确认当前环境是否支持 TP5（PHP + 扩展）

TP5 要求 PHP ≥ 5.4.0（推荐 ≥ 5.6），且必须启用 mbstring、openssl、pdo、json、curl。TP3.2 可以跑在 PHP 5.3 上，但 TP5 不行。

执行 php -v 查 CLI 版本；用 phpinfo() 或 php -r "echo PHP_SAPI;" 确认 Web SAPI（如 fpm-fcgi）是否一致
TP3.2 的 Runtime/ 目录默认可写，但 TP5 的 runtime/ 需要更严格权限（755 或 775），且不能放在 Web 可访问路径下
若项目用了 topthink/think-queue 或自定义 extend/ 类库，需确认它们是否兼容 PSR-4 自动加载 —— TP5 废弃了 TP3.2 的 Lib/ 和 Common/ 模式

不要直接 composer require topthink/framework=5.*

TP3.2 是单入口 + 手动加载，没有 composer.json 管理核心；硬加 TP5 依赖会导致自动加载冲突、Class 'Think\App' 找不到、vendor/autoload.php 和 ThinkPHP/Library/Think/Think.class.php 同时被引入而报致命错误。

btpanel phpsite 宝塔面板PHP网站

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

下载

正确做法：新建空目录，用 composer create-project topthink/think=5.1.* tp5-app（推荐从 5.1 开始，非最新 5.3，因 5.1 文档最全、生态最稳）
把原 TP3.2 的 Application/Home/Controller/ 逐个重构成 TP5 的 app/index/controller/，注意命名空间从 Home\Controller\IndexController 改为 app\index\controller\Index
config.php 和 database.php 要拆成多个小文件，放进 config/ 目录，且格式从 PHP 数组改为 return 数组（无 return 会报错）

路由和控制器调用方式完全不同

TP3.2 默认 URL 是 index.php?m=Home&c=Index&a=index，TP5 默认是 index.php/index/index/index，且不带模块名（除非开启 url_common_param）。硬搬旧路由规则会导致 404 或无限重定向。

TP5 的路由定义在 route/route.php，不是 Conf/config.php；URL_MODEL 配置已移除，改用 url_route_must 和 url_html_suffix
$this->display() 在 TP5 中必须显式引入模板引擎：use think\View;，或直接用 return view('index');
TP3.2 的 A('User') → D('User') 全部失效；TP5 统一用模型类 app\index\model\User，且必须继承 think\Model
数据库查询中，M('user') 已废弃，改用 Db::name('user') 或 UserModel::all()

缓存、Session、上传等基础功能需重适配

TP3.2 的 session_start() 手动调用、S() 缓存函数、U() 生成 URL，在 TP5 中全部语义变更或废弃，不改就会静默失败或返回空。

S('key', $val) → 改用 cache('key', $val)（需确保 cache 配置项存在）或 Cache::set('key', $val)
U('Index/index') → 改用 url('index/index')，且必须先在路由中注册该地址，否则返回空字符串
上传类 Think\Upload 已移除，改用 think\File 和 request()->file('image')
TP3.2 的 __ROOT__ 常量在 TP5 中不存在，前端资源路径建议用 __STATIC__/ 或配置 view_replace_str