Composer安装卡在curl或php -r阶段，主因是官方installer地址被干扰，换国内镜像源（如清华、阿里云、腾讯云）可解决；安装后须配置packagist镜像源才生效。
Composer 安装卡在 curl 或 php -r 阶段，大概率不是你网络差，而是官方安装脚本默认走的 https://getcomposer.org/installer 被干扰了——换国内镜像源就能绕过。
为什么直接运行官方安装命令会失败
官方 install.sh 本质是用 curl 下载 https://getcomposer.org/installer，再用 php 执行。这个 URL 在国内常出现超时、证书错误或返回空内容，错误信息通常是：curl: (7) Failed to connect 或 PHP Parse error: syntax error（因为下载到的是 HTML 错误页而非 PHP 脚本）。
这不是 Composer 本身的问题，而是中间 CDN 或 DNS 解析被干扰。镜像源不改逻辑，只换下载地址。
- 别试“多刷几次”，成功率不随次数线性提升
- 别手动下载
installer再执行——如果下载不完整，php installer会直接报语法错 - 优先用镜像站提供的「一键安装脚本」，它已预置可信 HTTPS 地址
推荐的稳定镜像源及对应命令
清华、阿里云、腾讯云镜像均同步及时，但协议和路径略有差异。注意：必须用镜像站提供的完整安装命令，不能只替换 URL。
- 清华镜像（推荐）：
php -r "copy('https://mirrors.tuna.tsinghua.edu.cn/composer/installer', 'composer-setup.php');"后接php composer-setup.php - 阿里云镜像：
php -r "copy('https://mirrors.aliyun.com/composer/installer', 'composer-setup.php');" - 腾讯云镜像：
php -r "copy('https://mirrors.cloud.tencent.com/composer/installer', 'composer-setup.php');"
所有镜像都提供 SHA384 校验值，执行前建议校验：php -r "if (hash_file('sha384', 'composer-setup.php') !== 'xxx') { unlink('composer-setup.php'); echo 'ERROR'; }"（把 xxx 换成镜像站页面公布的哈希值）。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
安装后必须改全局配置，否则仍走国外源
镜像源只解决安装问题，不改变后续 composer install 的行为。默认仍从 packagist.org 拉包，90% 的慢和失败发生在这里。
- 全局生效（推荐）：
composer config -g repo.packagist composer https://packagist.phpcomposer.com（此为旧镜像，已停用）→ 改用：composer config -g repo.packagist composer https://packagist.proxy.ustclug.org（中科大）或https://mirrors.aliyun.com/composer/ - 项目级覆盖：
composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/（仅当前目录有效） - 验证是否生效：
composer config -g repo.packagist应输出镜像 URL，而非https://packagist.org
注意：阿里云镜像要求 Composer 版本 ≥ 2.2；若提示 Invalid repository type，说明版本太低，先升级：composer self-update。
遇到 SSL certificate problem 别急着关验证
这是 cURL 报的常见错误，根源常是系统 CA 证书过期或缺失，尤其在 Docker 容器、CentOS 6/7 或某些 macOS Homebrew 环境中。
- 临时绕过（仅调试）：
export COMPOSER_DISABLE_TLS=1，但会失去传输加密，不推荐长期使用 - 正确做法：更新 CA 包。Ubuntu/Debian：
sudo apt update && sudo apt install ca-certificates；macOS：brew install ca-certificates - 若用自建代理或公司防火墙，检查是否拦截了
*.packagist.org域名或证书链不全
镜像站用的都是标准 HTTPS 证书，只要系统证书正常，就不会触发该错误——所以它其实是环境问题，不是镜像问题。
