ThinkPHP 8.0 要求 PHP 8.1+,需确认 framework 和 think-orm 均为 8.0.x/3.0+,且 whereTime() 等已移除,须改用显式门面或构造器调用。

TP8.0 在 PHP 8.2 下直接报错,大概率不是框架版本不对,而是你没满足最低运行门槛
ThinkPHP 8.0 **要求 PHP 8.1+** 才能正常启动,PHP 8.2 是完全支持的——但前提是框架本身是 8.0 正式版(非 alpha/beta),且 composer.lock 中依赖项已正确解析。常见误判是:看到 php think version 输出 v8.0.0 就以为万事大吉,结果 vendor/topthink/framework 实际加载的是未打 tag 的 dev-main 分支,或 topthink/think-orm 版本仍卡在 2.x。最稳验证方式:执行 composer show topthink/framework 和 composer show topthink/think-orm,确认两者均为 8.0.x 且 think-orm ≥ 3.0。
whereTime()、input() 这类调用一打开就 Fatal error,说明旧代码正踩中 TP8.0 的硬性移除点
TP8.0 彻底删除了魔术方法解析逻辑,whereTime、whereLike、input、session 等不再是函数或模型方法,而是必须显式调用门面或构造器。这类错误不会给你 warning,直接 Fatal error: Uncaught Error: Call to undefined method。
-
whereTime('create_time', 'today')→ 必须改写为where('create_time', '>=', date('Y-m-d'))->where('create_time', ',或封装成通用方法 -
input('id')→ 改为\think\facade\Request::get('id'),不要 rely onuse别名,避免自动加载冲突 -
redirect('user/index')→ 改为return \think\facade\Redirect::to('user/index'),注意返回值必须是 Response 实例 - 所有
whereIn('id', $ids)调用前加判空:!empty($ids) ? whereIn('id', $ids) : whereRaw('1=0'),否则空数组会抛异常
PHP 8.2 的 Dynamic property 警告不是警告,是明确告诉你 Model 属性没声明
TP8.0 模型继承自 think\model\Base,而 PHP 8.2 默认禁止动态属性创建。如果你还在用 $user->nickname = 'abc' 这种写法,会触发 Deprecated: Creation of dynamic property。这不是兼容层能兜住的问题,必须改代码。
- 模型类顶部显式声明所有可写属性:
protected string $nickname = ''; - 若属性来自数据库字段且不确定是否定义,用
#[\AllowDynamicProperties]注解(PHP 8.2+ 支持) - 避免在控制器里对模型实例赋值未声明属性,改用
data()或save(['nickname' => 'abc']) - 检查第三方扩展(如权限插件、日志中间件)是否通过
__set()动态设置模型属性,这类代码需重写
OPcache + JIT 配置错一个参数,TP8.0 在 PHP 8.2 下反而比 PHP 7.4 还慢
TP8.0 强依赖 OPcache 的 JIT 编译能力,但默认配置往往不生效。常见陷阱是 opcache.jit_buffer_size 小于 64M,或 opcache.jit 设为 1205(只做分析不编译)。
- 必须设
opcache.jit=1235(触发分析、编译、优化全流程) -
opcache.jit_buffer_size=256M(TP8.0 类加载量大,64M 容易溢出) -
opcache.save_comments=1(TP8.0 路由和注解依赖反射注释) - 每次修改 PHP 配置后,执行
sudo systemctl restart php8.2-fpm,别只 reload
真正难搞的不是语法升级,是那些没报错但行为已变的地方:比如 array_key_exists(null, $arr) 在 PHP 8.2 下直接 TypeError,而 TP8.0 的验证器里可能还藏着这种调用;又比如 count(null) 不再静默转为 0,旧业务逻辑里漏掉的判空会在上线后突然崩掉——这些得靠真实请求流量触发,光跑单元测试不够。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











