thinkphp6开发版需显式指定版本安装,因官方latest标签已指向tp8 dev-main分支,直接create-project不加版本会拉取不兼容的tp8环境;正确命令为composer create-project "topthink/think:6.0.x-dev" tp6-dev,并需验证php think version输出含v6.x且无v8字样。

ThinkPHP6 开发版不是默认安装的版本,直接 composer create-project topthink/think 拉下来的是稳定版(如 v6.1.x),甚至可能意外拉到 TP8 dev-main 分支。要装开发版,必须显式指定版本约束。
为什么 create-project 不加版本会出错
Composer 默认行为是找 latest stable,但 ThinkPHP 官方包在 Packagist 上的 topthink/think 的 latest 标签已指向 dev-main(即 TP8 预览分支),而非 TP6 开发分支。你运行不带版本的命令,极大概率得到一个无法兼容 TP6 文档和扩展的环境。
- 现象:执行
php think version显示v8.0.0-dev或报错Class "think\App" not found - 根本原因:TP6 的开发分支是
6.0.x-dev或6.1.x-dev,不是dev-main - TP6 已进入维护期,官方不再推送新 stable 版本,但
6.0.x-dev和6.1.x-dev仍持续修复关键问题
composer create-project 必须带版本约束
安装 TP6 开发版唯一可靠方式是强制指定分支名,且需用双引号包裹防止 shell 解析错误:
composer create-project "topthink/think:6.0.x-dev" tp6-dev
- 推荐用
6.0.x-dev:兼容性最稳,文档和扩展(如think-multi-app)都基于此分支开发 - 慎用
6.1.x-dev:部分扩展尚未完全适配,think-view等可能报命名空间错误 - 绝对不要用
dev-main或不写版本——这不是 TP6
装完立刻验证是否真为 TP6 开发版
进项目根目录后,必须马上确认三件事,否则后续所有操作(比如装 think-multi-app)都会失败:
- 运行
php think version,输出应类似v6.0.45或带-dev后缀,绝不能含v8 - 检查
composer.json中"topthink/framework"的 require 版本是否为"^6.0.0@dev"或"6.0.x-dev" - 执行
php think build index测试命令是否存在——若提示Command "build" is not defined,说明多应用扩展没生效,或根本就不是 TP6 环境
开发版和稳定版的目录结构、路由机制、配置加载顺序完全一致,但开发版会包含未合入 stable 的 bugfix 和调试支持。真正容易被忽略的是:装完开发版后,composer update 默认不会升级到更新的 -dev 提交,必须显式运行 composer update --prefer-source 才能拉取最新开发快照。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











