目前不存在ThinkPHP 8,官方最新稳定版是ThinkPHP 6.3.x;TP7仍为开发预览版,无正式发布;所有“TP8”说法均属误传或虚构,Composer无法安装TP8。

ThinkPHP 8 尚未发布,目前(截至 2024 年)官方最新稳定版是 ThinkPHP 6.3.x,而 ThinkPHP 7 仍处于开发预览阶段,无正式版,更不存在 ThinkPHP 8。所有声称“安装 TP8”的教程或命令,要么是误传,要么指向非官方分支或虚构版本。
composer create-project 能否直接装 TP8?
不能。执行以下命令会失败或拉取错误内容:
composer create-project topthink/think tp8
原因:topthink/think 包的最新稳定 dist 版本仍是 v6.3.10(以实际 Packagist 页面为准),dev-main 分支对应的是 TP7 预览版,且不保证兼容性与稳定性。
-
composer create-project topthink/think tp8默认安装最新 stable 版 —— 实际得到的是 TP6 -
composer create-project "topthink/think:dev-main" tp8可能拉到 TP7 预览代码,但dev-main不是生产就绪版本 - 没有
^8.0.0、v8.x等合法 Composer 版本约束存在
如何确认当前可用的 ThinkPHP 版本?
查官方源和 Packagist 是唯一可靠方式:
立即学习“PHP免费学习笔记(深入)”;
- 访问 https://www.php.cn/link/ba3a0adbebf2cfb367817fad99c6fb13,看
Latest version和Stable releases - 终端运行:
composer show topthink/think --all
,输出中只会出现6.0.x、6.1.x、6.2.x、6.3.x及少量dev-开头的开发分支 - GitHub 仓库
top-think/think的main分支 README 明确标注 “ThinkPHP 6 —— 下一代 PHP 框架”,TP7 目前仅在独立分支thinkphp7中试验
想用最新特性该选 TP6 还是 TP7 预览版?
生产项目必须选 ThinkPHP 6.3;仅学习或验证新 API 可试 TP7,但需接受风险:
-
TP6.3:PHP 7.2+,长期维护,文档完整,生态组件(如topthink/think-queue)全部适配 -
TP7 dev:要求 PHP 8.1+,大量底层重构(如容器、事件系统重写),config/结构变更,中间件签名不兼容,且无中文文档、无稳定扩展包 - 执行
composer require topthink/think-orm在 TP7 下可能报依赖冲突 —— 因为 ORM 包尚未发布支持 TP7 的版本
正确搭建 ThinkPHP 6.3 环境的最小命令集
这是目前最稳妥、可立即投入开发的流程:
composer create-project topthink/think tp6 cd tp6 php think run
注意几个关键点:
- 不要加
--prefer-dist或--no-dev,TP6 的think命令依赖topthink/think-installer,删 dev 会导致命令丢失 - 若提示
zlib_decode(): data error,是 Composer 缓存损坏,运行composer clear-cache后重试 - Windows 下首次运行
php think run可能报Could not open input file: think,改用php ./think run(加./) - Web 服务器部署时,务必把 Web 根目录指向
public/,而非项目根目录
真正要上 TP7,得等官方发布首个 alpha 版并同步更新 Packagist 上的版本号 —— 那之前所有“TP8”说法,都是混淆概念。框架版本不是靠改文件夹名或 composer.json 里手写 "topthink/think": "^8.0" 就能生效的。











