ThinkPHP 8 必须使用 PHP 8.0 或更高版本,最低要求 PHP 8.0.0,推荐 PHP 8.1+,LTS 分支已适配 PHP 8.3;需启用 PDO、mbstring、OpenSSL、JSON、GD、sockets 等扩展,国产数据库驱动须用线程安全(TS)版本。

ThinkPHP 8 必须使用 PHP 8.0 或更高版本,不是建议,而是硬性要求。
最低版本是 PHP 8.0.0
框架底层大量依赖 PHP 8.0 引入的语法和运行时特性,例如:
- 构造函数属性提升(
public function __construct(protected Container $container)) - 联合类型(
string|int|null) - 原生 Attribute 注解(用于路由、验证等)
- match 表达式
在 PHP 7.4 或更低版本下执行 composer require topthink/think 会直接失败,报错提示无法解析依赖,因为 composer.json 中明确声明了 "php": "^8.0"。
推荐使用 PHP 8.1+(尤其是生产环境)
虽然 TP8 在 PHP 8.0.0 上可启动,但部分关键特性(如命名参数调用、JIT 编译支持、某些反射行为)需 8.1 及以上才能完整生效。官方基准测试显示,TP8 在 PHP 8.2 下比在 8.0 下性能再提升约 5–8%。
另外,TP8 的 LTS 分支已适配 PHP 8.3,包括对 #[\Override] 等新注解的支持。
修复 Core bailout 状态损坏安全问题,以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误,改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
PHP 8.0.x 小版本也有注意事项
若使用 PHP 8.0.x,建议不低于 8.0.26——早期 8.0.0~8.0.12 存在若干与 PSR-17/18 实现兼容性相关的问题,可能导致 HTTP 响应工厂异常或中间件链中断。
执行 php -v 后,取输出的主版本号(如 PHP 8.2.15 → 主版本为 8.2),再按官网推荐选择 TP8 小版本:
• PHP 8.0–8.1 → 选 thinkphp 8.0.*
• PHP 8.2–8.3 → 选 thinkphp 8.1.*
别忘了配套扩展
除 PHP 版本外,还需确保启用以下扩展:
- PDO(数据库必需)
- mbstring(多字节处理)
- OpenSSL(HTTPS、加密)
- JSON(API 常用)
- GD(验证码、图片处理)
- sockets(WebSocket 调试与部分驱动需要)
TP8 对扩展的线程模型更敏感:例如达梦、人大金仓等国产数据库驱动,必须使用 PHP 8.x 的线程安全(TS)版本,NTS 版本将加载失败。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










