应优先使用华为云镜像并配置process-timeout=1800、retry-auth-failure=true及http-proxy（如需），同时确保php_openssl、php_curl启用且Xdebug关闭，可解决90%的composer install卡住问题。
直接换镜像 + 调超时，90% 的卡住问题当场解决。别等它自己动，它不会动。
为什么 composer install 会卡住不动
不是 Laravel 本身的问题，是 Composer 在连 packagist.org（默认源）时被阻断或响应极慢。国内直连经常触发 curl error 28（超时）、curl error 60（证书验证失败），或者卡在 “Resolving dependencies” 后就停住，连日志都不输出。
常见诱因包括：
- PHP 的
disable_functions里禁了proc_open、exec等函数（尤其 Windows WAMP/XAMPP 环境） - 没开
php_openssl或php_curl扩展 - 公司网络屏蔽了 GitHub API 或 HTTPS 请求
- 阿里云镜像对 Laravel 11.x 某些包返回 404（2026 年 4 月起已确认）
换哪个镜像最稳、怎么换
优先用华为云镜像 —— 当前（2026 年 8 月）实测对 Laravel 11.x 兼容性最好，阿里云镜像偶尔 404，Laravel China 镜像已停用。
全局生效（推荐）：
composer config -g repos.packagist composer https://mirrors.huaweicloud.com/repository/php/
只对当前项目生效（调试用）：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer config repos.packagist composer https://mirrors.huaweicloud.com/repository/php/
验证是否生效：
composer config -l | grep repo
看到输出中包含 https://mirrors.huaweicloud.com/repository/php/ 就对了。
必须同步调整的三个配置项
光换镜像不够，还要调参数，否则遇到弱网或大包仍可能中断：
-
process-timeout：设为1800（30 分钟），避免中途断掉：composer config -g process-timeout 1800
-
retry-auth-failure：开启自动重试：composer config -g retry-auth-failure true
-
http-proxy（仅限企业内网）：如果公司强制走代理，不配这个会一直卡在 DNS 解析：export http_proxy=http://your-proxy:8080
（Linux/macOS）或set http_proxy=http://your-proxy:8080
（Windows CMD）
还是卡？先做这三件事再重试
别重复跑 composer create-project，先清理干扰项：
- 删掉本地缓存：
composer clear-cache
- 检查 PHP 扩展是否齐全：
php -m | grep -E "(openssl|curl)"
，缺就去php.ini里开 - 临时关掉 Xdebug：
XDEBUG_MODE=off composer create-project laravel/laravel blog
（Xdebug 会让 Composer 变慢 3–5 倍）
如果卡在 Git 克隆阶段（比如提示 Cloning into '...'... 后不动），大概率是 Git 的 SSL 证书路径错或验证失败 —— 直接运行 git config --global http.sslverify false 临时绕过（仅限调试，勿提交到团队环境）。
真正麻烦的点往往不在镜像本身，而在 PHP 环境是否“干净”：扩展缺失、函数被禁、代理未配、Xdebug 开着 —— 这些比换源更常导致无声卡死。
