Composer安装慢或卡住90%非网络问题，而是未切国内镜像源；应执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/全局换源并清缓存，验证输出为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。

Composer 安装慢或卡住，90% 不是网络问题，而是默认源在境外且没走 HTTPS 代理或 DNS 解析异常；换国内镜像源能直接提速 5–10 倍，且不需改系统配置、不依赖代理工具。

Composer 全局镜像设置命令（推荐直接执行）

执行一条命令即可永久切换为阿里云镜像，后续所有 composer install、composer update 都自动走国内 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/"}。若报错 Could not fetch，说明当前 Composer 还没连通外网——先跳到下个副标题。

安装 Composer 时就卡在 “Downloading…”？先确认 PHP 和 cURL 环境

新电脑常见问题是 PHP 编译时没带 openssl 或 cURL 扩展，导致 Composer 下载阶段直接 hang 住（无报错、无进度、CPU 占用低）。

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

• 运行 php -m | grep -i curl 和 php -m | grep -i openssl，两个都必须有输出
• 若缺失，Windows 用户重装 PHP 时勾选 curl 和 openssl；macOS 用 brew install php 默认已含；Linux 用户检查 php-curl 和 php-openssl 包是否安装
• 临时绕过证书验证（仅调试用）：composer config -g secure-http false，但不建议长期开启

为什么 composer create-project 仍很慢？镜像没覆盖全部请求

阿里云镜像只代理 Packagist 主索引，但某些包（如私有包、GitHub 直链、dist 类型的 ZIP 下载）仍会直连 GitHub 或 GitLab，这时需额外配置：

• 强制所有 ZIP 下载走镜像：composer config -g github-protocols https
• 加速 GitHub 资源（可选）：git config --global url."https://github.com/".insteadOf "https://api.github.com/"（注意：这不是 Composer 配置，是 Git 层）
• 若项目 composer.json 中写了 "repositories" 自定义源，优先级高于全局镜像，需手动把其中的 packagist.org 替换为 mirrors.aliyun.com/composer

换源后 composer update 报 “Package not found”？缓存未清理

Composer 会缓存旧源的元数据，换镜像后不清理会导致查不到包（尤其从官方源切到国内镜像时）：

• 清空本地缓存：composer clear-cache
• 删掉项目根目录下的 vendor/ 和 composer.lock（如有），再重新 composer install
• 极少数情况需删全局缓存目录：composer config -g cache-dir 查路径，手动删其内容

镜像同步有小时级延迟，如果某包昨天刚发布，国内镜像可能还没同步到——此时不是配置问题，等几小时或临时切回官方源单次拉取：composer update --repository=https://packagist.org。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！