直接换阿里云镜像源、清理缓存、指定稳定版本并跳过脚本,可将TP6安装从几十分钟压至2分钟内;根本原因是默认连packagist.org导致超时限速,且小文件多、无并发下载。

直接换阿里云镜像源,再加几个关键参数,TP6安装能从几十分钟压到2分钟内完成。
为什么 composer create-project topthink/think 会卡住
本质不是命令写错了,而是默认连 packagist.org,国内直连经常超时、限速或被重置。你看到的 “Downloading xxx” 停在 99%、Cloning into、GitHub rate limit 错误,基本都指向网络层。另外,TP6 依赖里含大量小文件(比如 stub、测试用例),走默认 dist 包 + 没开并发下载,速度天然受限。
- 别信“等等就好”——Composer 不会自动重试失败的包,卡住就是卡住
- 别用
composer create-project topthink/think不带版本号——可能拉到 dev 分支或 TP8 预览版,触发更多不稳定依赖 - Windows 上 Git Bash 或 CMD 中执行,如果没装 Git 命令行工具,会卡在 clone 步骤且不报明错
必须执行的三步加速操作
这三步缺一不可,顺序不能乱:
- 全局切镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/(验证用composer config -g repo.packagist,输出应为 URL 字符串) - 清理旧缓存:
composer clear-cache(尤其之前失败过,缓存 zip 可能已损坏) - 指定稳定小版本 + 跳过脚本:
composer create-project "topthink/think:^6.3.0" tp6-demo --no-scripts --no-autoloader(^6.3.0锁死补丁级,--no-scripts防止 install 过程中执行耗时的 post-autoload-dump)
装完立刻要做的两件事
很多人以为装完就结束了,其实最关键的提速点在这两步:
- 手动补 autoload:
composer dump-autoload -o(-o表示优化,生成 classmap,比默认 PSR-4 查找快得多) - 确认
think文件权限:Linux/macOS 下运行chmod +x think;Windows 下确保think文件末尾是\n(不是\r\n),否则 shebang 行失效,php think直接报错
容易被忽略的底层瓶颈
即使网络和命令都对了,TP6 启动仍慢,大概率是 PHP 自身没调优:
- OPcache 必须启用:
opcache.enable=1和opcache.enable_cli=1都要开(CLI 模式不开,php think命令也慢) - 检查是否启用了
mbstring、openssl、json扩展——缺一个,框架在初始化阶段就会 fallback 到慢路径 - WSL 或 Docker 环境下,
vendor/放在 Windows 文件系统挂载点上(如/mnt/c/xxx),IO 性能暴跌,务必移到 Linux 原生路径(如~/project)
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











