ThinkPHP版本管理工具的使用与配置_Composer镜像源优化-ThinkPHP-PHP中文网

composer安装thinkphp卡顿是因packagist.org国内不稳定，需提前配置阿里云镜像源；tp6类找不到是自动加载未触发，须确保vendor/autoload.php路径正确且执行composer install；升级应使用topthink/framework而非thinkphp/framework；composer.lock必须提交以保证环境一致。

thinkphp版本管理工具的使用与配置_composer镜像源优化

Composer 安装 ThinkPHP 时卡在 `composer create-project` 或报 `Connection timed out`

本质是默认源（packagist.org）在国内访问不稳定，不是 ThinkPHP 本身的问题。镜像源必须在执行命令前就生效，否则项目骨架拉不下来就直接失败。

运行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 全局切换（推荐阿里云，稳定且同步及时）
若已卡住，先 Ctrl+C 中断，再 composer clear-cache 清缓存，避免旧元数据干扰
验证是否生效：运行 composer config -g repo.packagist，输出应为镜像地址而非原始 URL
注意：某些公司内网会拦截非白名单域名，此时需联系运维加 mirrors.aliyun.com 到代理白名单

ThinkPHP 6.x 用 `composer create-project` 后无法启动，提示 `Class 'think\App' not found`

这是自动加载没触发导致的，常见于未正确执行 composer install 或 autoload.php 路径写错。TP6 不再自带完整框架代码，全部靠 Composer 自动加载。

确认项目根目录下存在 vendor/autoload.php，且入口文件 public/index.php 中 require __DIR__.'/../vendor/autoload.php'; 路径正确
不要手动复制 vendor 目录，必须用 composer install（或 create-project 自带的）生成 autoload 文件
如果改过 composer.json 的 autoload 段，记得运行 composer dump-autoload 重建映射
Windows 下路径大小写不敏感但 Linux 敏感，vendor 写成 Vendor 就会找不到类

升级 ThinkPHP 版本时 `composer update thinkphp/framework` 报 `could not find package`

TP6+ 已不再维护 thinkphp/framework 这个包名，主包是 topthink/framework，旧文档或搜索结果容易误导。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

查当前版本：运行 composer show topthink/framework，不是 thinkphp/framework
升级命令应为 composer update topthink/framework，加上 --with-dependencies 可同步更新关联组件（如 topthink/think-orm）
若 composer.json 里还写着 "thinkphp/framework": "^6.0"，手动改成 "topthink/framework": "^6.0" 再 update
TP8 预发布版暂未进 packagist 稳定源，想尝鲜得加 "minimum-stability": "beta" 并指定版本号，但生产环境不建议

`composer.lock` 提交与否？多人协作时为什么 A 升级后 B 运行报错

必须提交 composer.lock。它锁定了所有依赖的确切版本和哈希值，没有它，composer install 会按 composer.json 重新解析最新兼容版本，极易引发不一致。

B 执行 composer install 前，确保 composer.lock 是最新版（git pull 后检查），否则会安装旧版依赖
若 A 手动删了 composer.lock 再 commit，B 拉下来就只能跑 composer install 出随机版本，ORM 行为或路由解析可能突变
CI/CD 流程中，务必用 composer install --no-dev（生产环境）或 --no-interaction（自动化），避免交互阻塞
本地开发可 composer update，但每次 update 后要立刻 git add composer.lock 并提交