ThinkPHP 8.0 能用，且是官方明确支持 PHP 8.3 的首个稳定版本；5.x 系列不支持，强行运行易崩溃，迁移需同步完成目录结构、命名空间、配置格式、数据库驱动及扩展生态升级。

ThinkPHP 8.0 能用，且是官方明确支持 PHP 8.3 的首个稳定版本；ThinkPHP 5.x（含 5.0/5.1/5.2）不能直接用，即使加兼容层也极易在运行时崩溃。

---

ThinkPHP 8.0 是唯一推荐用于 PHP 8.3 的 ThinkPHP 版本

• 官方发布说明和 composer.json 中已将 "php": "^8.0 || ^8.1 || ^8.2 || ^8.3" 明确写入最低要求
• 所有核心类（think\App、think\db\Connection、think\Container）已重写反射逻辑，不再依赖 ReflectionParameter::getClass() 返回非 null —— 避开了 PHP 8.3 对联合类型（如 ?string）、mixed 参数的反射限制
• opcache.save_comments=0 不再导致路由/验证器失效：注解解析改用 AST 分析 + 缓存键隔离，不依赖 PHP 内置反射读取 docblock

你如果正在用 ThinkPHP 5.1.40+ 并强行跑在 PHP 8.3 上：

• 会遇到 TypeError 在 think\Request::param() 或模型自动注入处随机抛出
• Facade::__callStatic 缺少返回类型声明，在 PHP 8.1+ 已是 Deprecated，PHP 8.3 下部分 SAPI（如 FPM）可能升级为 Warning 并中断响应流

---

ThinkPHP 5.x 迁移到 8.0 的真实成本点

不是“改几行就能跑”，而是以下三类改动必须同步完成：

• 目录结构与命名空间强制变更

  立即学习“PHP免费学习笔记（深入）”；

  • app/ 下控制器不再自动映射到 app\controller\，必须显式声明 namespace app\controller;
  • 模型类必须继承 think\Model（不再是 think\Model\Base），且默认启用严格模式（strict => true）
  • config/ 文件全部转为 PHP 返回数组，废弃 .ini 和 .yaml 支持

• 数据库驱动不可降级回填

  • 'type' => 'mysql' 彻底无效，必须改为 'type' => 'pdo' 或 'type' => 'mysqli'
  • think\db\connector\Mysql 类已被移除，所有自定义连接逻辑需重写为 think\db\connector\Pdo 子类
  • Db::query() 返回值类型从 mixed 收紧为 array|int|false，旧代码中 count(Db::query(...)) 必须先判型

• 扩展包生态断层明显

  

  btpanel phpsite 宝塔面板PHP网站

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

  下载
  • topthink/think-captcha 3.x 最后更新于 2021 年，不兼容 PHP 8.3 的 random_bytes() 错误处理路径
  • topthink/think-migration 2.x 仍用 func_get_args() 构造 SQL，PHP 8.3 下触发 TypeError
  • 替代方案：直接用 robmorgan/phinx + 自定义 ThinkPHP 适配器，或升级至 topthink/think-migration 4.0（仅支持 TP8）

---

PHP 8.3 特有陷阱：ThinkPHP 8.0 也需手动绕过

这些不是框架 Bug，而是 PHP 8.3 语言层行为变更，必须在业务代码里显式防御：

• str_contains()、str_starts_with() 等新函数在 think\helper\Str 中未封装，直接调用即可，但注意：它们对 null 输入一律返回 false，旧逻辑 if (strpos($str, 'x') !== false) 不能简单替换成 if (str_contains($str, 'x'))，因为前者对 null 报 Warning，后者静默失败

• match 表达式不允许隐式类型转换，比如：

  match ($_GET['status'] ?? 0) {
      0 => 'draft',
      '1' => 'published', // PHP 8.3 报错：non-exhaustive match，'1' ≠ 1
  }

  必须统一类型，或改用 if-elseif

• <strong>serialize()</strong>/unserialize() 若被自定义模型实现，必须返回 array，否则反序列化直接失败 —— ThinkPHP 8.0 的 Model 基类已强制校验，但老项目迁移时容易漏掉子类重写

---

PHP 8.3 下跑 ThinkPHP，最易被忽略的不是语法报错，而是「没报错却逻辑错」：比如 array_key_exists(null, $arr) 在 PHP 8.3 返回 false（PHP 7.4 是 true），而 ThinkPHP 8.0 的验证器规则 requireIf 内部用了这个判断 —— 如果你复用了旧版验证规则数组，它会在特定条件下跳过必填校验。这种问题不会出现在日志里，只能靠请求参数覆盖测试发现。