直接换腾讯云镜像源可将composer create-project速度从几小时缩至2–3分钟，因默认境外源存在DNS解析与下载链路卡顿；需执行composer config -g repo.packagist composer https://packagist.proxy.tencent.com，并配合--prefer-dist参数。
直接换国内镜像源，composer create-project 命令就能从几小时缩到 2–3 分钟。不是网络问题，是默认源在境外，DNS 解析+下载链路全卡在中间节点。
为什么 composer create-project topthink/think 特别慢
ThinkPHP5 的 topthink/think 包依赖大量子包（如 topthink/framework、psr/log、monolog/monolog 等），而 Composer 默认使用 packagist.org（位于欧洲），每次 resolve 依赖都要跨洋请求，且不支持断点续传。国内直连常出现超时、重试、TCP 重传，表现为命令卡在 Loading composer repositories with package information 或 Installing dependencies 阶段不动。
这不是你本地 PHP 或网络配置的问题，也和是否开代理无关——只要没显式指定镜像，Composer 就走原生源。
必须执行的三步镜像配置（2026 年有效）
截至 2026 年，packagist.phpcomposer.com 已停用，packagist.laravel-china.org 响应不稳定。当前唯一稳定可用的是腾讯云镜像：
立即学习“PHP免费学习笔记（深入）”；
- 全局设置（推荐，一劳永逸）：
composer config -g repo.packagist composer https://packagist.proxy.tencent.com - 如果只想本次生效（适合 CI/临时环境）：
composer create-project topthink/think tp5 --prefer-dist -vvv --repository=https://packagist.proxy.tencent.com - 验证是否生效：运行
composer config -g repo.packagist，输出应为https://packagist.proxy.tencent.com
注意：--prefer-dist 必须保留，它强制走压缩包安装而非 Git 克隆，能再提速 30%；-vvv 可看到实时下载域名，确认流量已走腾讯镜像。
create-project 执行后仍卡在 cloning 阶段？检查 Git 源
ThinkPHP5 项目模板（topthink/think）本身是个 Git 仓库，Composer 在初始化时会调用 git clone。如果你的 Git 本身走代理或被墙，也会卡住。
解决方法：
- 临时禁用 Git 的 HTTPS 代理：
git config --global --unset http.proxy、git config --global --unset https.proxy - 强制 Git 走镜像（针对 GitHub）：
git config --global url."https://github.fastgit.xyz/".insteadOf "https://github.com/" - 或者干脆跳过 Git，改用 ZIP 模式（需 Composer 2.2+）：
composer create-project topthink/think tp5 --prefer-dist --no-interaction，该模式不触发git clone
装完访问 http://localhost/tp5/public/ 报 404？不是安装问题
这是 Web 服务器配置问题，和安装速度无关，但新手容易误判为“装坏了”。关键点只有两个：
- Apache/Nginx 必须把
DocumentRoot指向tp5/public/目录，不是tp5/根目录 - Apache 需开启
mod_rewrite，Nginx 需配置try_files $uri $uri/ /index.php?$query_string;
最简验证方式：进入 tp5/public/ 目录，用 PHP 内置服务器启动：php -S localhost:8000 -t .，然后访问 http://localhost:8000。能打开就说明安装完全成功，只是 Web 服务没配对路径。
镜像配置看似简单，但漏掉任意一个环节（比如只设了镜像却没关 Git 代理，或用了失效的旧镜像地址），都会让安装回到龟速。2026 年起，packagist.proxy.tencent.com 是目前实测唯一持续稳定的源，其他所谓“PHP 镜像”多数已降级为缓存代理，无法覆盖全部 ThinkPHP 依赖树。
