目前没有稳定可用的 ThinkPHP 8 正式版,composer create-project topthink/think 默认安装的是生产就绪的 ThinkPHP 6.3.x;所谓“TP8”在官方源、Packagist、GitHub 均无对应版本记录,dev-main 分支实为 TP7 预览版;确认版本应以 php think version 或查看 composer.json 和 App.php 中的 VERSION 常量为准。

目前没有稳定可用的 ThinkPHP 8(TP8)正式版,composer create-project topthink/think 默认安装的是 ThinkPHP 6.3.x —— 这是截至 2026 年 3 月唯一生产就绪、文档完整、生态健全的版本。
为什么 composer create-project topthink/think tp8 不等于 TP8
Packagist 上 topthink/think 的 latest stable 版本仍是 v6.3.10;dev-main 分支实际指向 TP7 预览版(非 TP8),且 GitHub 官仓 top-think/think 的 main 分支 README 明确标注为 “ThinkPHP 6”;所谓 “TP8” 在官方源、Packagist、GitHub Issues 或 Release 页面中均无对应 tag、分支或发布记录。
-
composer create-project topthink/think tp8→ 实际得到 TP6.3 -
composer create-project "topthink/think:dev-main" tp8→ 拉取 TP7 预览代码,PHP 8.1+ 强制要求,中间件/容器/配置结构不兼容 TP6,think-orm等核心扩展尚未适配 -
composer show topthink/think --all输出中只含6.0.x~6.3.x和少量dev-前缀分支,无8.0.0、v8或^8版本约束
如何确认你装的到底是哪个版本
别信目录名或命令里的 “tp8”,以运行时输出和源码为准。最可靠的方式是进项目根目录执行:
php think version
或直接查看 vendor/topthink/think/composer.json 中的 "version" 字段;再保险一点,打开 thinkphp/library/think/App.php,搜索 const VERSION —— TP6.3 固定返回类似 '6.3.10' 的字符串。
立即学习“PHP免费学习笔记(深入)”;
- 若输出
7.x-dev或报错Class "think\Container" not found:你正在跑 TP7 预览版,不是 TP8,也不推荐用于任何线上环境 - 若
php think run启动失败,提示require_once(.../think-installer)找不到:大概率删了--no-dev导致开发依赖丢失,TP6 的命令行工具依赖它
正确部署一个可立即开发的 ThinkPHP 项目
放弃 “TP8” 这个不存在的幻觉,用 TP6.3 是当前唯一低风险、高效率的选择。它支持 PHP 7.2+,兼容宝塔、Nginx、Apache、Swoole,所有中文文档、教程、插件(如 think-queue、think-captcha)都基于它构建。
- 执行:
composer create-project topthink/think myapp
- 进入目录:
cd myapp
- 启动内置服务:
php think run
(默认监听127.0.0.1:8000) - 宝塔部署时,网站根目录设为
/www/wwwroot/example.com/myapp/public,伪静态选ThinkPHP规则
真正要注意的不是“怎么装 TP8”,而是别被网上过时或错误的标题误导——查 Packagist、看 GitHub tag、运行 php think version,这三步比背命令重要得多。











