PHP依赖解析失败多因SemVer理解偏差或配置错误：^1.2.3允许次版本升级（<2.0.0），~1.2.3仅允许修订版升级（<1.3.0）；0.x阶段^等价于~；需规范预发布标签、dev前缀及数字格式；platform配置须匹配真实PHP环境；推荐使用phlak/semver等工具安全操作版本。
PHP项目中出现依赖解析失败，八成和语义化版本控制（SemVer）理解偏差或配置不当有关。不是版本号写得不对，而是没读懂它想表达的兼容性含义。关键不在“怎么装”，而在“怎么读”和“怎么写”。
看懂版本约束符号的真实含义
Composer 里的 ^ 和 ~ 看似相似，行为却完全不同：
- ^1.2.3 表示 ≥1.2.3 且 <2.0.0 —— 允许次版本和修订版升级，但绝不跨主版本
- ~1.2.3 表示 ≥1.2.3 且 <1.3.0 —— 只允许修订版升级，次版本都锁死
- ^0.x.y（如 ^0.8.4）在 0.x 阶段等价于 ~0.8.4，因为 0.x 被视为不稳定开发期，主版本 0 不代表兼容保障
- 别用 ~>1.0 这类写法——它根本不是合法约束符，会直接触发
Could not parse version constraint
验证你的版本字符串是否合规
一个看似正常的字符串，可能因细微格式问题被 composer/semver 拒绝：
- 预发布标签只能用 -alpha、-beta、-rc、-dev，不能写
-alpha1或-stable-release - 开发分支必须加 dev- 前缀，比如
dev-main或dev-feature/login，不能反着写成main-dev - 禁止使用斜杠、下划线、空格等非标准分隔符，
1.0.0/meh或1.0.0_beta都会报Invalid version string - 数字部分不补零，
1.05.0是非法的，应写作1.5.0
匹配 PHP 自身版本与扩展兼容性
低代码或混合环境中，光管包版本不够，还得对齐运行时环境：
立即学习“PHP免费学习笔记（深入）”；
- Composer 的
platform配置必须真实反映当前 PHP 版本和已启用扩展，例如：
"platform": {"php": "8.2.15", "ext-mbstring": "8.2.15"} - 升级 PHP 主版本（如从 8.1 → 8.2）后，某些扩展行为变更（如
mbstring默认编码）、函数弃用（如mysql_*）会间接导致依赖包运行异常，即使 Composer 安装成功 - 若提示 conflict 但看不出哪个包冲突，加
-v参数运行composer update，看详细回溯中最早被拒绝的约束条件
用工具代替手算，避免手动递增出错
不要用 str_replace 或 explode('.', $v) 来“升级版本号”。这类操作极易忽略进位（如 1.9.9 → 1.10.0）、预发布逻辑（1.0.0-alpha.1 → 1.0.0-alpha.2）或构建元数据（+build.123）。
- 推荐使用 phlak/semver：支持完整 SemVer 2.0 规范，一行代码即可安全递增：
$v = new \PHLAK\SemVer\Version('1.2.3'); $v->patch(); // → 1.2.4 - 需要解析约束并判断兼容性？phar-io/version 提供
VersionConstraintParser，可精确校验^7.0是否包含7.0.17或排除6.4.34 - 所有操作都基于规范校验，不会生成非法字符串，也避免因字符串处理引入的隐性 bug
