Composer中文镜像配置与Composer工作区隔离方案-composer-PHP中文网

composer全局镜像配置常因键名错误（如repos.packagist）、缺type值、url末尾无/或项目级repositories字段屏蔽而静默失效；项目级配置更可靠，需在项目根目录执行composer config repo.packagist composer https://mirrors.aliyun.com/composer/。

composer中文镜像配置与composer工作区隔离方案

国内用 Composer 不配镜像源，根本装不完——不是慢，是卡死在 TLS 握手、DNS 解析或 403 错误上；多个项目共用 vendor 或 composer.json，必然冲突，Composer 没有“多版本并存”机制，所谓隔离全是靠你手动控制路径、加载时机和约束范围。

composer config -g repo.packagist 命令为什么总不生效

这条命令写错一个字符就静默失效，且不报错。常见错误包括：

repo.packagist 写成 repos.packagist（多一个 s），Composer 完全忽略该字段
漏掉 -g 参数，结果只改当前项目 composer.json，换目录就失效
URL 少了末尾斜杠，比如写成 https://mirrors.aliyun.com/composer，请求会拼成 /composerpackages.json 导致 404
省略 composer 这个 type 值，Composer 2.0+ 会 fallback 到 packagist.org

验证是否成功：运行 composer config -g repo.packagist，输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的 JSON 对象。空、null、报错或旧地址，都说明没配对。

项目级镜像配置比全局更可靠

全局配置在宝塔、CI 或多用户环境下极易失效，因为执行命令的用户（如 www 或 runner）和配置用户（如 root）不一致。项目级配置可被 Git 跟踪，且不会被覆盖：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

进项目根目录，运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g）
它会自动在 composer.json 顶层写入 "repositories" 字段，key 固定为 "packagist"
如果项目已有 "repositories" 字段，确保它是对象结构（不是数组），否则命令可能误删私有源

注意："packagist.org": false 这类写法会直接屏蔽全局镜像，但项目级配置不受影响。

vendor 目录必须严格按项目隔离

多个项目共用 vendor/ 或通过软链接共享，会导致 Class not found、autoload 映射错乱、CI 构建失败。关键控制点：

每个项目必须有自己的 composer.json 和独立根目录，禁止在父目录（如 /var/www/）下运行任何 composer 命令
禁用 COMPOSER_VENDOR_DIR 环境变量或全局 config 设置，避免跨项目写入
Docker 构建时，不要 COPY vendor/，而应在容器内执行 composer install --no-dev --optimize-autoloader --classmap-authoritative --no-interaction
子项目（如 subtree）需在自身目录运行 composer install --no-autoloader --no-scripts，并显式设置 "vendor-dir" 和 psr-4 autoload

生产环境依赖隔离不能只靠 --no-dev

--no-dev 只跳过安装 require-dev 包，但不会清理已生成的 autoload 映射、composer.lock 中的 dev 记录，也不会删除 vendor/bin/ 或 tests/ 目录：

检查 composer.lock：运行 grep -A5 '"packages-dev"' composer.lock | head -20，非空即风险
补救必须加 composer dump-autoload --no-dev，否则 vendor/autoload.php 仍含 tests/ 映射
Docker 构建后应清理残留：find vendor -name 'tests' -o -name 'Tests' -o -name 'bin' -o -name '.git' | xargs rm -rf
CI 流水线中，构建前务必先跑 composer update --no-dev --lock，生成不含 dev 包的新 composer.lock

真正起作用的不是开关，而是每一步是否被严格执行——尤其 composer install 后的清理动作，最容易被跳过，也最常引发线上故障。