^允许主版本不变的向后兼容更新,~限制更严格的次版本内更新,*用作通配符但需谨慎使用以避免不兼容风险。
在使用 Composer 管理 PHP 项目依赖时,版本约束(version constraints)决定了可以安装的包的版本范围。正确理解
^
、
~
和
*
这些符号,有助于控制依赖更新行为,避免意外引入不兼容的更改。
1. 插头符号 ^:遵循语义化版本的向后兼容更新
^
是最常用的版本约束符,表示允许安装与指定版本兼容的最新版本,前提是不改变主版本号(Major version)。
它基于
语义化版本(SemVer)
规则:版本格式为
主版本.次版本.修订版本
(如 2.3.4),其中:
主版本(Major):重大变更,可能包含不兼容的修改
次版本(Minor):新增功能,向后兼容
修订版本(Patch):修复 bug,向后兼容
使用
^
时,Composer 允许更新次版本和修订版本,但不会升级主版本。
示例:
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑,通过深度错误修复、底层性能微调以及安全加固,旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范,不包含破坏性变更。
下载
表示允许
且
表示允许
且
比较特殊:由于主版本为 0,通常认为不稳定,因此只允许修订更新,即
且
2. 波浪符号 ~:保守的增量更新
~
提供更严格的版本限制,通常用于只允许修订版本(Patch)或特定范围的次版本更新。
它的规则是:锁定主版本和次版本,允许修订版本更新;但如果指定了两个版本段,则行为略有不同。
示例:
表示允许
且
—— 即允许 1.2.x 的更新,不允许升级到 1.3.0
等价于
,表示允许
且
表示
且
可以看出,
~
比
^
更保守,适合对依赖变化敏感的项目。
3. 星号 *:通配符,灵活但需谨慎
*
是一个通配符,常与其他版本格式结合使用,表示某个位置可以是任意值。
它通常出现在版本号的部分段落中,用来定义更宽泛的匹配规则。
示例:
表示允许所有 1.x 的版本,等价于
且
表示允许 1.2.x 的所有版本,即
且
或
已过时,推荐使用
或明确版本
注意:
单独使用(如
)表示接受该包的任何版本,风险较高,不推荐在生产环境中使用。
基本上就这些。掌握 ^、~ 和 * 的差异,能让你更精准地控制依赖版本,提升项目的稳定性和可维护性。合理使用这些符号,既能享受自动更新的便利,又能规避潜在的兼容性问题。
^1.2.3≥1.2.3<2.0.0^2.0.0≥2.0.0<3.0.0^0.5.0≥0.5.0<0.6.0~1.2.3≥1.2.3<1.3.0~1.2~1.2.0≥1.2.0<1.3.0~2.0≥2.0.0<2.1.01.*≥1.0.0<2.0.01.2.*≥1.2.0<1.3.0*.xx.***"vendor/package": "*"