正确配置镜像源需执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，确保含-g、正确键名、type值及末尾斜杠，否则静默失效；配完须验证输出为完整json且用curl -i确认url可达。
直接用 composer require 就能拉 GitHub 上的 PHP 库，但前提是镜像源配置正确——否则会卡在 Loading composer repositories 或报 could not find package，不是库不存在，是你根本没连上元数据接口。
镜像源必须匹配 GitHub 包的元数据协议
GitHub 上的开源 PHP 库（比如 monolog/monolog、phpunit/phpunit）本身不托管在 GitHub，而是注册在 Packagist；Composer 先从镜像源拉 packages.json 元数据，再根据其中记录的 GitHub 地址下载 ZIP。所以镜像源必须同时提供：完整元数据 + 对应 ZIP 分发节点，缺一不可。
- 阿里云、清华、腾讯云镜像都满足，它们同步的是 Packagist 官方元数据，并把 ZIP 文件缓存在国内 CDN 节点
- 千万别用已停服或不同步的镜像（如旧版
packagist.phpcomposer.com），会导致Package not found或签名校验失败 - 验证方式：运行
curl -I https://mirrors.aliyun.com/composer/packages.json，返回HTTP/2 200才算可用
全局镜像配置命令必须写对三个硬性要素
执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 是最简方案，但漏掉任意一个都会静默失效——不报错，但实际仍直连海外源。
-
-g不能省：少了就只改当前目录，换项目就失效 -
repo.packagist是固定键名：写成repos.packagist或packagist.org都无效 -
composer是 type 值：不是注释，也不是可选参数，必须紧接在键名后 - URL 必须 HTTPS + 末尾斜杠：
https://mirrors.aliyun.com/composer/，少斜杠会拼出/composerpackages.json导致 404
配完立刻验证：composer config -g repo.packagist，输出必须是完整 JSON 对象，比如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或报错，说明没写进去。
require GitHub 库时别手动填 git+https URL
绝大多数 GitHub 开源 PHP 库已在 Packagist 注册，直接 composer require vendor/package-name 即可。只有极少数未提交到 Packagist 的私有库，才需要手动指定 Git 地址。
- 正确写法：
composer require symfony/console:^7.0（它背后就是 GitHub 上的symfony/console仓库） - 错误写法：
composer require git+https://github.com/symfony/console.git—— 这绕过 Packagist 元数据，无法被镜像加速，且版本约束失效 - 如果真要拉未注册的 GitHub 库，必须在
composer.json的repositories字段里显式声明类型为vcs，并确保该仓库有合法composer.json
首次拉取前务必清缓存并删 lock 文件
换镜像后第一次执行 composer require，如果还卡住或报 hash 错误，大概率是旧缓存和 lock 文件残留导致的冲突。
- 先运行
composer clear-cache清掉本地缓存 - 删掉项目根目录的
composer.lock和vendor/目录（如有） - 再执行
composer require vendor/package-name，让 Composer 重新解析依赖树并生成新 lock 文件 - 若团队协作，记得把新生成的
composer.lock提交进 Git —— 它记录了具体镜像源地址和包哈希，保证所有人行为一致
真正容易被忽略的是：镜像只加速元数据加载和 ZIP 下载，不解决 Resolving dependencies 卡顿。如果卡在这里几十秒，问题出在 composer.json 的 PHP 版本约束太宽、dev 分支引用太多，或者本地 Composer 版本太低——这时候换镜像毫无意义。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
