更换国内镜像源可解决Composer安装超时问题，如使用Laravel China或阿里云镜像，支持全局或临时配置，还可调整超时时间、启用长连接及设置代理优化网络请求。
如果您尝试通过 Composer 安装依赖包时遇到请求超时问题，这通常是由于默认的镜像源位于境外服务器导致网络连接不稳定。以下是几种有效解决该问题的配置方法。
本文运行环境：MacBook Pro，macOS Sonoma
一、更换为国内镜像源
通过将 Composer 的默认仓库替换为国内镜像，可显著提升下载速度并避免因网络延迟导致的超时。
1、执行命令全局更换镜像源：composer config -g repo.packagist composer https://packagist.laravel-china.org。
2、验证配置是否生效：composer config -l | grep repos，确认输出中包含指定镜像地址。
3、恢复官方源时使用：composer config -g –unset repos.packagist。
二、使用临时镜像参数
在不修改全局配置的前提下，仅对当前项目启用镜像加速，适用于需要频繁切换环境的开发场景。
1、进入项目根目录后运行：composer require illuminate/support –prefer-dist -vvv，同时结合镜像参数调试。
2、添加临时镜像参数执行安装：composer config repos.packagist composer https://mirrors.aliyun.com/composer/ && composer require “package/name”。
3、操作完成后可删除临时配置：composer config –unset repos.packagist。
三、调整 Composer 超时时间与协议设置
延长网络等待时限并优化传输协议，有助于在弱网环境下完成依赖拉取。
1、设置 HTTP 超时时间为 600 秒：composer config -g process-timeout 600。
2、启用 HTTP 长连接以减少握手开销：composer config -g http.keepalive true。
3、强制使用 HTTPS 协议并信任国内 CA 证书（如必要）：composer config -g secure-http true。
四、配置系统级代理服务
当本地网络受限时，可通过代理通道转发 Composer 请求至外部网络。
1、检查当前网络是否具备可用代理服务，例如 SOCKS5 或 HTTP 代理。
2、设置 Composer 使用代理：composer config -g http-proxy http://127.0.0.1:1080（请根据实际代理地址和端口调整）。
3、取消代理配置命令为：composer config -g –unset http-proxy。
composer laravel 端口 macbook mac 阿里云 macos cos 镜像源 网络问题 laravel composer require macos http https