0

0

解释composer的"semver"版本规范

冰火之心

冰火之心

发布时间:2025-09-29 17:08:02

|

416人浏览过

|

来源于php中文网

原创

Composer使用semver(X.Y.Z)管理PHP依赖,主版本号变更含破坏性修改,次版本号为向后兼容的新功能,修订号为bug修复;通过精确版本、~(波浪号)、^(插入号)、范围操作符等约束指定依赖版本,推荐使用^确保安全升级,同时支持dev分支引用但不建议用于生产,实现依赖的灵活与稳定平衡。

解释composer的\

Composer 使用 semver(Semantic Versioning,语义化版本)来管理 PHP 项目的依赖版本。它的格式通常是 X.Y.Z,分别代表主版本号、次版本号和修订号。通过这种规范,开发者能清楚地知道一个版本更新是否包含破坏性变更。

版本号结构:X.Y.Z

一个典型的版本号如 1.4.2

  • X(主版本号):当你做了不兼容的 API 修改时递增。
  • Y(次版本号):当你以向后兼容的方式添加新功能时递增。
  • Z(修订号):当你修复问题但保持功能不变(即向后兼容的 bug 修复)时递增。

版本约束写法

composer.json 中,你可以用多种方式指定依赖版本,Composer 能根据 semver 规则自动选择合适的包版本。

1. 精确版本

直接指定完整版本号:

"monolog/monolog": "1.12.0"

只允许安装这个确切版本。

2. 波浪号 ~(最常用)

允许修订或次版本的更新,但不跨越主版本或指定的最低边界。

  • ~1.2 相当于 >=1.2.0 且
  • ~1.2.3 相当于 >=1.2.3 且

适合希望获得 bug 修复和小功能更新,但避免破坏性变更的场景。

魔珐星云
魔珐星云

无需昂贵GPU,一键解锁超写实/二次元等多风格3D数字人,跨端适配千万级并发的具身智能平台。

下载

3. 插入号 ^(推荐默认使用)

允许所有向后兼容的更新,基于 semver 规则。

  • ^1.2.3 表示 >=1.2.3 且
  • ^0.3.4 表示 >=0.3.4 且 (0.x 版本中任何次版本更新都可能有破坏)
  • ^0.0.3 只允许更新到

这是 Composer 默认推荐的写法,确保安全升级。

4. 范围与逻辑操作符

可以组合多个条件:

  • >=1.0 :大于等于 1.0 且小于 2.0
  • >1.0 :大于 1.0 且小于等于 2.0
  • 1.0 - 2.0:等价于 >=1.0.0 且

dev 分支与特殊版本

你也可以引用开发中的分支:

  • dev-maindev-develop:指向某个 Git 分支的最新提交。
  • 1.5.x-dev:表示 1.5 分支的开发版本,支持通配。

注意:这类版本不稳定,不建议在生产环境使用。

基本上就这些。理解 semver 帮助你控制依赖更新范围,在获取新功能和保持系统稳定之间取得平衡。Composer 的版本解析器会综合所有依赖关系,自动选出满足条件的最优版本。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2787

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1685

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1547

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

1016

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1484

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1255

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1569

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1307

2023.11.13

菜鸟裹裹入口以及教程汇总
菜鸟裹裹入口以及教程汇总

本专题整合了菜鸟裹裹入口地址及教程分享,阅读专题下面的文章了解更多详细内容。

0

2026.01.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 9.1万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 9.8万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号