thinkphp 6 必须用 composer 安装,唯一正确方式是 composer create-project topthink/think tp6;其他方式(如下载 zip、空目录下 composer install)会导致自动加载缺失、class not found 或白屏。

ThinkPHP 本身不强制绑定 Composer,但现代 ThinkPHP(6.x+)完全基于 Composer 构建,composer 不是“怎么用”,而是“必须用”——没它连框架都装不起来。
安装 ThinkPHP 6 必须走 composer create-project
直接下载 ZIP 或手动复制 vendor 文件夹会缺失自动加载、依赖版本约束和事件钩子,后续升级或加扩展必然报错。
-
composer create-project topthink/think tp6是唯一推荐的初始化方式 - 别用
composer install在空目录下跑——没有composer.json就没东西可装 - 如果提示
Could not find package topthink/think,先运行composer clear-cache,再换国内镜像:composer config -g repo.packagist composer https://packagist.phpcomposer.com(注意:该镜像已停用,应改用https://mirrors.aliyun.com/composer/)
composer require 加扩展时要注意命名空间和版本兼容
ThinkPHP 6 的扩展包大多以 topthink/think-xxx 命名,但不是所有都适配 TP6;比如 think-wechat 是社区维护的,官方未认证,得看其 composer.json 里是否声明 "thinkphp": "^6.0"。
- 加包前先确认文档是否写明 “支持 ThinkPHP 6” —— TP5 的包在 TP6 下大概率报
Class not found - 避免无版本号直加:
composer require topthink/think-captcha可能装最新版(如 v4),而 TP6.3 默认只认 v3;应显式指定:composer require topthink/think-captcha:^3.0 - 装完后检查
config/app.php是否自动注册了服务提供者;没注册就得手动加到providers数组里
本地开发改了 composer.json 后,composer update 很危险
TP6 的核心包(topthink/framework)和扩展之间有强版本耦合,composer update 默认升级所有包,极易导致 Method not found 或 Call to undefined function。
- 只更新某个包:用
composer update topthink/think-queue,别光输composer update - 升级框架主版本(如 6.0.x → 6.3.x)前,务必查官方 迁移指南,尤其关注中间件、事件、验证器等 API 变动
- 改完
composer.json后,建议先composer update --dry-run看实际要动哪些包,再决定是否执行
最常被忽略的一点:TP6 的命令行工具(php think)本质是 vendor/bin/think 的符号链接,一旦 composer install 失败或权限异常,这个文件就失效——此时运行 php think 报错 command not found,但错误信息根本不提“找不到 bin 文件”,只会卡在 autoload 阶段。遇到这种问题,先 ls -l vendor/bin/think 看链接是否存在且可读。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











