magicoli/php-bump-library

PHP项目版本管理库

v1.0.2 2023-07-21 01:56 UTC

This package is auto-updated.

Last update: 2024-09-21 04:40:38 UTC


README

Version Stable License

此库提供了自动化PHP项目版本管理的任务。

它允许您根据不同的级别(主版本、次版本、补丁版本、开发版、beta版、rc版)增加版本,并更新各种文件中的版本引用,如PHP文件、README.md、package.json和readme.txt。

安装

在您的项目目录中运行以下命令

composer require --dev magicoli/php-bump-library

并将以下脚本添加到您的composer.json文件中

 "scripts": {
    "bump-version": "robo --load-from=vendor/magicoli/php-bump-library/RoboFile.php bump:version"
  }

用法

composer bump-version [level]

[level]替换为您想要增加的版本级别的名称,例如majorminorpatchrcbetadev。如果您省略它,默认级别为patch

或者,您可以直接使用以下命令运行脚本

robo bump:version
# or
robo --load-from=path/to/RoboFile.php bump:version

请确保调整RoboFile.php以匹配您的项目中的实际文件路径。

关于版本

语义版本遵循特定的版本增加顺序

开发阶段(M.m.p-stage)

  • 开发版:尚未稳定或发布的开发版本。
  • beta版:预发布版本,接近稳定发布,但仍可能存在一些小问题。
  • rc版:发布候选版本,接近最终发布,可能需要额外的测试。

发布(M.m.p)

  • 补丁:向后兼容的错误修复。
  • 次版本:添加了功能,但仍然以向后兼容的方式。
  • 主版本:重大变化。

请注意,devbetarc版本被认为低于正常版本,通常用于预发布阶段或开发周期:1.0-dev < 1.0-beta < 1.0-rc < 1.0

例如,如果您的版本是1.0.0,您在dev级别增加它,新版本将是1.0.1-dev(注意补丁增加)。如果您将dev增加到beta,它将保持主版本并变为1.0.1-beta。如果您不带参数将1.0.1-beta增加,新版本将是1.0.1

许可

此库根据AGPL-v3许可协议授权。