Composer在Homestead环境怎么配？虚拟机环境与中文镜像【实战】-composer-PHP中文网

homestead中composer install卡在“loading composer repositories”是因默认连不上packagist.org，需立即执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（末尾斜杠不可少），并验证输出为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，同时检查项目级repositories是否覆盖全局配置、清理缓存、更换dns及刷新composer.lock。

composer在homestead环境怎么配？虚拟机环境与中文镜像【实战】

Homestead里不配镜像，composer install 十有八九卡在 “Loading composer repositories” —— 不是网络差，是根本连不上 packagist.org。

进 Homestead 后第一件事：全局配阿里云镜像

Homestead 虚拟机默认用的是官方源，而国内对 packagist.org 的 DNS 解析慢、TLS 握手常失败、又没 CDN，结果就是干等不动，且不报错。必须手动切镜像：

执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意末尾斜杠不能少）
验证是否生效：composer config -g repo.packagist 输出应为 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
如果提示 Permission denied，说明 ~/.composer/ 目录权限不对，运行 sudo chown -R $USER:$USER ~/.composer 再试
别用已停服的 https://packagist.phpcomposer.com，它 2023 年就下线了

为什么 `composer diagnose` 还显示 packagist.org？

常见错觉：配了镜像但 composer diagnose 的 “Repo” 行仍显示 https://packagist.org。这通常是因为项目级配置覆盖了全局设置：

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

检查项目根目录下的 composer.json 是否有 "repositories" 字段；若有，且里面写了 "packagist.org": false 或空对象，composer 就会退回到默认源
临时解决：删掉 composer.json 中整个 "repositories" 段，再运行 composer clear-cache
彻底验证：跑一次 composer update -vvv | grep -i "downloading.*mirrors\.aliyun"，看到域名才是真生效

Homestead 网络卡顿还跟 DNS 有关

即使镜像配对了，composer install 仍可能卡几秒——根源常在 DNS 解析慢。Homestead 默认用 VirtualBox 提供的 DNS，不稳定：

临时改 DNS：echo "nameserver 114.114.114.114" | sudo tee /etc/resolv.conf（重启虚拟机后失效）
持久化方案：编辑 /etc/network/interfaces，在 iface eth0 inet dhcp 下加一行 dns-nameservers 114.114.114.114 8.8.8.8，然后 sudo systemctl restart networking
别信“加代理就能好”——镜像和 DNS 是两回事，代理解决不了本地 DNS 缓存缺失问题

项目首次 `install` 还卡？试试这几个参数

有些项目依赖多、包体积大，即使镜像+DNS都调好了，仍可能因交互或源码拉取慢而卡住：

加 --no-interaction 避免等待用户输入（比如脚本里问要不要删除旧 vendor）
加 --prefer-dist 强制走压缩包而非 git clone（快 3–5 倍）
加 --optimize-autoloader 减少后续 autoload 开销，顺便触发更严格的校验，提前暴露问题
组合命令示例：composer install --no-interaction --prefer-dist --optimize-autoloader

真正容易被忽略的点：Homestead 里改完镜像，composer.lock 文件若早先是在没镜像的机器上生成的，里面可能硬编码了原始 dist URL（比如指向 github.com），这种情况下仅配镜像无效，必须跑一次 composer update 才能刷新 lock 文件里的地址。