应放宽composer.json中版本约束，如将"monolog/monolog": "1.25.0"改为"^1.25 || ^2.0"，再运行composer update monolog/monolog --with-all-dependencies，并用composer why-not定位阻断依赖。
composer install 报 “found package x but it does not match your constraint” 怎么办
这不是包不存在，而是你 composer.json 里写的约束太窄，和 Packagist 上实际发布的版本对不上。比如你锁死 "monolog/monolog": "1.25.0"，但官方早已停更 v1，只推 v3，Composer 就只能干瞪眼。
关键动作是看报错末尾的 available package versions 列表——它才是真实可用的版本，不是你本地 vendor/ 里那个旧货。如果列表里有 3.4.0、2.10.2，而你约束还卡在 ^1.25，那问题就定位了。
- 别直接删版本写
"*"，等于放弃控制 - 优先用语义化组合：如
"monolog/monolog": "^1.25 || ^2.0"，明确允许多主版本，但不盲目跳到 v3 - 确认代码是否真依赖 v1 特性（比如
Monolog\Handler\StreamHandler在 v2/v3 里路径没变，基本可兼容） - 改完后跑
composer update monolog/monolog --with-all-dependencies，只动它和直系依赖，不波及其他
composer why-not 能快速定位谁在挡路
报错只说“装不了 laravel/sanctum:^3.0”，但从不告诉你谁不让装。这时候 composer why-not 是唯一靠谱的起点：
composer why-not laravel/sanctum:^3.0 会输出类似：
myapp/myproject dev-main requires guzzlehttp/guzzle (^6.5) laravel/sanctum ^3.0 requires guzzlehttp/guzzle (^7.2)
冲突根源一下就落在 guzzlehttp/guzzle 上。再顺藤摸瓜：composer why guzzlehttp/guzzle，常会暴露出某个已废弃的 SDK 或 require-dev 里的测试工具还在死守 v6。
-
composer why查的是「已安装」包的依赖链；composer why-not才是查「想装但装不上」的根因 - 输出中带
(required by)的行就是阻断点，优先查这些包的文档或 GitHub issues，看是否已有兼容版 - 注意
conflict字段：有些包明写"conflict": {"php": "，哪怕你没装 php，它也可能被间接拉入并触发全局校验失败
强制降级或跨主版本调整要分两步走
想把 symfony/console 从 v6 降回 v5？不能只改 composer.json 然后 composer update —— Composer 会拒绝破坏现有依赖树。必须分步操作：
- 先只改
composer.json，加版本约束："symfony/console": "^5.4" - 运行
composer update symfony/console --with-all-dependencies，让 Composer 主动重算依赖链，必要时连带降级symfony/dependency-injection或symfony/event-dispatcher - 如果仍失败，说明其他包硬依赖 v6（比如新版本的
doctrine/doctrine-bundle），这时得查composer prohibits symfony/console:5.4看谁在禁止 - 绝对避免
composer update --ignore-platform-reqs后直接上线，PHP 版本、扩展缺失等平台问题会被掩盖，CI 构建可能通过，生产环境却崩
旧包没 composer.json 怎么塞进项目
像 DB.php 这种 PHP 5.2 风格的老库，Packagist 没它，composer require 必报 Could not find a version。它根本不是“包”，只是文件集合。
正确做法是绕过 Packagist，用 path 类型仓库 + files 自动加载：
- 把库放到
lib/legacy-db/，手动补一个最简composer.json：{ "name": "legacy/db", "version": "1.0.0", "autoload": { "files": ["DB.php", "MySQL.php"] } } - 在项目根目录
composer.json的repositories里加："repositories": [ { "type": "path", "url": "./lib/legacy-db" } ] - 执行
composer require legacy/db:1.0.0，再composer dump-autoload -
files是关键：它让 Composer 启动时无条件require_once这些文件，不走 PSR-0/4 映射，专治无命名空间、无类名规范的老代码
真正的难点不在怎么加，而在于确认这些老文件之间有没有硬编码路径（比如 require_once '../config.php'）、是否依赖已被移除的 PHP 函数（如 mysql_connect），这些得人工扫一遍，Composer 帮不上忙。
