composer提示“Failed to download...”的解决办法

更换国内镜像源可解决因网络波动导致的下载失败，推荐使用阿里云或 Laravel China 镜像；2. 清除 Composer 缓存并删除 vendor 目录与 composer.lock 后重新安装可修复缓存损坏问题；3. 检查网络连接、代理设置及 PHP 配置（如 openssl 扩展和 allow_url_fopen）确保环境正常。

遇到 Composer 提示“Failed to download...”时，通常是因为网络连接、镜像源不稳定或本地配置问题导致的。下面是一些常见且有效的解决办法。

检查网络连接

Composer 需要能正常访问远程仓库才能下载包。确保你的网络通畅，尤其是如果你在使用公司代理或防火墙环境：

• 尝试 ping packagist.org 看是否能连通
• 如果使用代理，需为 Composer 设置代理： composer config --global http-proxy http://your-proxy:port
• 临时关闭代理测试：composer config --global --unset http-proxy

更换国内镜像源（推荐）

默认源在国外，容易因网络波动失败。可切换为国内镜像加速下载：

轻舟办公

基于AI的智能办公平台

194

查看详情

• 使用阿里云镜像： composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• 或使用 Laravel China 镜像： composer config -g repo.packagist composer https://packagist.laravel-china.org
• 恢复官方源命令： composer config -g --unset repos.packagist

清除缓存并重试

Composer 缓存损坏也可能导致下载失败：

• 清除缓存： composer clear-cache
• 删除 vendor 目录和 composer.lock 后重新安装： rm -rf vendor composer.lock && composer install

检查 PHP 和扩展配置

某些 PHP 扩展缺失会导致无法发起 HTTPS 请求：

• 确认 openssl 扩展已启用：php -m | grep openssl
• 检查 php.ini 中是否禁用了 allow_url_fopen 或 open_basedir 限制
• 使用 composer diagnose 检查环境问题： composer diagnose

以上就是composer提示“Failed to download...”的解决办法的详细内容，更多请关注php中文网其它相关文章！