ThinkPHP 8 要求 PHP ≥8.0.0(推荐 8.1+),不支持 8.3+;TP6 要求 PHP ≥7.4(推荐 8.0);必需扩展包括 fileinfo、openssl、mbstring、PDO(含对应驱动)、curl,gd 推荐启用。

ThinkPHP不同版本对PHP环境的要求差异明显,选错版本容易导致报错、功能异常甚至无法启动。核心不是“能跑就行”,而是匹配官方明确支持的范围。
ThinkPHP 8 的 PHP 版本要求
必须使用 PHP 8.0 或更高版本(推荐 8.1 / 8.2),不支持 PHP 8.3 及以上。PHP 8.3 中部分函数签名或错误处理机制变更,会导致 ThinkPHP 8 路由解析失败、类加载报错或扩展兼容问题。
ThinkPHP 6 的 PHP 版本要求
官方明确要求 PHP ≥ 7.4,但生产环境强烈建议用 PHP 8.0。PHP 7.4 已于 2022 年底停止维护,部分安全补丁和扩展更新不再覆盖;而 PHP 8.0 在性能、类型系统和错误提示上更稳定,与 TP6 LTS(如 6.1/6.2)配合最成熟。
必需启用的 PHP 扩展
以下扩展缺一不可,否则项目启动即失败或关键功能不可用:
- fileinfo:文件上传、MIME 类型检测依赖它
- openssl:HTTPS 请求、JWT、加密解密必需
- mbstring:多字节字符串处理(中文路径、JSON 编码等)
- PDO + pdo_mysql:数据库连接基础,仅启 pdo 不够,必须对应驱动
- curl:HTTP 客户端、第三方 API 调用常用
- gd(可选但推荐):验证码、图片缩略图、水印等功能需要
配置注意事项
光装扩展不够,还要确认实际生效:
- 在终端执行
php -m | grep -E "(fileinfo|openssl|pdo)"验证是否已加载 - Web 环境中访问
phpinfo()页面,搜索对应模块名,确认“enabled”状态 - 宝塔等面板安装扩展后,务必点击「重启 PHP 服务」,否则配置不生效
- Linux 手动编译 PHP 时,configure 参数需显式包含
--enable-mbstring --with-openssl --enable-fileinfo等
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











