必须更换Composer镜像源，正确命令为composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，字段名、type值、URL格式三者缺一不可，否则静默失效。
国内用 Composer 默认源下载 PHP 包，基本就是卡在 Downloading 或直接超时——这不是你网络差，是物理距离+TLS 握手慢+防火墙干扰共同导致的。换镜像不是“可选优化”，是必须做的第一步。
composer config -g repo.packagist 命令怎么写才真正生效
90% 的失败源于命令敲错三个细节：字段名、type 值、URL 格式。必须严格按以下格式执行：
-
repo.packagist（不是repos.packagist，多一个s就静默失效） - 第二个参数必须是
composer（这是仓库类型声明，漏掉会 fallback 到官方源） - URL 必须以
https://开头，且末尾带/（https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌）
正确命令示例：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否写入成功：composer config -g repo.packagist
输出应为完整 JSON：{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。如果返回空、null 或报错，说明没生效。
为什么宝塔面板里设了全局镜像还是慢
宝塔中「PHP 管理器」或「一键部署」功能通常以 www 用户身份运行，而 composer config -g 默认写的是当前登录用户的配置（比如 root）。结果就是你在终端里 composer install 很快，但宝塔后台点部署却依然卡住。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
立即学习“PHP免费学习笔记（深入）”；
- 查实际执行用户：在宝塔【终端】里先切到
www用户，再运行composer config -g repo.packagist - 若为空，需用该用户身份重配：
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 脚本或 systemd 服务同理——别依赖全局配置，改用临时参数更可靠
项目级配置比全局更安全，但要注意覆盖风险
进项目根目录后执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g），这条命令会**全量替换** composer.json 中的 repositories 字段，而不是追加。
- 如果项目已定义私有 Git 源（如
"my-vcs": {"type": "vcs", "url": "https://git.example.com/pkg"}），执行后会被清空 - 安全做法是手动编辑
composer.json，在repositories数组里显式添加 packagist 镜像项，并确保"packagist.org": false写在根节点（非repositories内部） - 已有
composer.lock的项目首次用新镜像，大概率报 hash 不匹配；删掉vendor和composer.lock再install更稳妥
临时换源只对 install/update 有效，require 不认 --repository-url
临时参数 --repository-url=xxx 优先级最高，但它只对 composer install 和 composer update 生效。很多人想用 composer require foo/bar --repository-url=xxx 加速单个包安装，结果发现完全不走镜像——这是 Composer 的设计限制，不是 bug。
- 调试镜像是否可用？用
composer install -vvv --repository-url=https://mirrors.aliyun.com/composer/，加上-vvv才能看到真实请求域名 - CI 脚本中推荐固定用临时参数，避免因用户权限或环境差异导致行为不一致
- 别用已停用的地址（如
https://packagist.phpcomposer.com），现在访问直接 404；阿里云、华为云、中科大镜像目前仍稳定
镜像只解决下载慢，不解决 Resolving dependencies 卡顿。如果 update 卡在解析阶段，问题出在 composer.json 的约束写法或本地 PHP 环境，和镜像无关。
