镜像未生效需同时满足：全局配置为合法JSON且URL以https://开头并结尾带/、项目composer.json不含repositories字段、清除对应镜像元数据缓存；验证需检查p2接口版本列表与Last-Modified时间戳。
composer install -vvv 日志里出现 Downloading https://packagist.org/，说明镜像根本没生效
这不是网络慢或 DNS 问题，是 Composer 完全没走你配的镜像。关键看第一行 Downloading 的 URL——它才是真实请求地址。
必须满足三个硬性条件，镜像才可能被加载：
-
composer config -g repos.packagist（注意是复数repos）输出必须是完整 JSON，如{"type":"composer","url":"https://mirrors.aliyun.com/composer/"} - URL 必须以
https://开头且末尾带/，写成https://mirrors.aliyun.com/composer会拼出非法路径 - 项目根目录的
composer.json不能含"repositories"字段（包括空数组[]或空对象{}），否则全局配置被彻底屏蔽
快速验证：进项目目录执行 composer config repositories，有输出就说明项目级配置在起作用，此时 composer config -g 的结果无效。
日志里报 “Could not find package” 或 “xxx 3.6.0 not found”，大概率是元数据缓存没刷新
Composer 默认复用本地 packages.json 缓存（15 分钟内不过期），哪怕镜像站已同步新版本，它仍按旧索引算依赖，导致“明明网页上有，命令却找不到”。
别只跑 composer clear-cache——它不删元数据缓存，只清 ZIP 包和部分 dist 文件。
真正要动的是缓存目录下的镜像子路径：
- 查路径：
ls -d ~/.composer/cache/repo/https---mirrors.aliyun.com-composer - 删掉它：
rm -rf ~/.composer/cache/repo/https---mirrors.aliyun.com-composer - Windows 用户对应路径：
%APPDATA%\Composer\cache\repo\https---mirrors.aliyun.com-composer
删完立刻运行 composer show monolog/monolog，Composer 会强制重拉最新元数据。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
日志中出现 SSL certificate problem 或 JSON decode error，不是 PHP 配置问题，而是镜像返回了异常响应
这类错误常被误判为 CA 证书过期，其实更可能是镜像源本身异常：返回 HTML 页面（比如人机验证）、BOM 头、乱码、或已停服（如 https://packagist.phpcomposer.com 自 2023 年底已下线）。
先绕过 Composer，直接测镜像可用性：
-
curl -I https://mirrors.aliyun.com/composer/packages.json—— 必须返回HTTP/2 200 - 若返回
404，检查 URL 是否少斜杠；若返回Could not resolve host，是 DNS 污染，可加--resolve测试 - 若返回 HTML 内容（
Content-Type: text/html），说明该镜像不适合 CI/CD 场景，换阿里云或腾讯云源
某些错误如 file_put_contents(): Only variables should be passed by reference 实际是镜像返回了 BOM 头，PHP 解析 JSON 失败抛出的误导性错误。
镜像元数据接口（p2）返回的版本列表缺新 tag，说明同步延迟，不是你操作有问题
Packagist 网页显示 v3.6.0 ≠ 镜像的 p2 接口已同步。最准验证方式是比对官方源与镜像源的版本列表：
- 查官方最新版：
curl -s https://packagist.org/p2/monolog/monolog.json | jq -r '.packages."monolog/monolog" | keys[]' | sort | tail -3 - 查镜像（阿里云为例）：
curl -s https://mirrors.aliyun.com/composer/p2/monolog/monolog.json | jq -r '.packages."monolog/monolog" | keys[]' | sort | tail -3
若镜像输出缺少最新 tag，就是同步延迟。阿里云通常滞后 1–6 小时，冷门包可能更久。此时等或临时切回官方源更实际：composer config --global repo.packagist composer https://packagist.org。
同步状态不能靠“页面能打开”判断，必须验证 p2 接口和 Last-Modified 时间戳——这是最容易被跳过的一步。
