Composer如何设置包安装的优先级_Composer仓库优先级配置说明【详解】-composer-PHP中文网

composer仓库优先级由repositories数组顺序与"packagist": false共同决定：未禁用时官方源兜底、顺序无效；禁用后严格按数组从上到下匹配，首个返回元数据的仓库生效，后续忽略。

composer如何设置包安装的优先级_composer仓库优先级配置说明【详解】

Composer 仓库优先级不是靠“设开关”或“调参数”实现的，而是由 repositories 数组顺序 + "packagist": false 配置共同决定的——不关掉默认源，私有包再靠前也白搭；顺序写错，第一个命中的仓库就锁死结果。

根本原因是 packagist.org 默认隐式启用，且排在所有显式仓库之后。即使你把私有仓库写在 repositories 第一位，Composer 仍会先查 packagist.org（只要它没被禁用），而 packagist.org 一旦返回了同名包的元数据，就直接跳过你的私有源。

必须在 repositories 数组中加入 {"packagist": false} 来禁用默认源——注意它不是仓库，不能放最前面，得放在私有源之后
私有源类型为 vcs 时，只对 require 中显式声明的包生效，不会参与全局元数据合并；想覆盖 laravel/framework 这类基础包，得用 type: "composer" 并确保其 packages.json 明确列出了该包
composer config -g repos.packagist false 是全局禁用，会破坏其他项目，别用

镜像（如 https://mirrors.aliyun.com/composer/）只是 packagist.org 的只读代理，不托管私有包；它和私有源不是“并列候选”，而是“分工协作”关系——私有源负责特定包，镜像兜底其余公开包。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

正确顺序：repositories 数组里，私有源（type: "composer"）放最前 → 镜像源（type: "composer"）放最后 → {"packagist": false} 放数组末尾
千万别同时写 "https://packagist.org" 和镜像地址，否则 Composer 会优先连原站，断网即失败，镜像根本不会触发
验证是否生效：运行 composer config repositories，确认输出中包含你的私有 URL，且 "packagist": false 存在；再跑 composer update -vvv vendor/package 看日志里实际请求了哪个源

因为 Composer 查找是「命中即停」，不是「比对全部再选最优」。只要第一个仓库返回了满足约束的版本，哪怕它更旧、更不稳定，后续仓库里的 dev-main 或 2.1.0@beta 都不会被考虑。

prefer-stable 不影响优先级逻辑，它只在多个候选版本都满足 minimum-stability 时起排序作用；单独设它没用，必须配 "minimum-stability": "stable"
VCS 类型仓库（如 Git 地址）不生成全局 packages.json，所以无法被用于“匹配查找”，只响应显式 require "vendor/pkg": "dev-branch" 这种写法
package 类型仓库必须手动写全 version、dist 字段，否则 composer install 会跳过该条目