README

描述

Laravel Bump 是一个包，允许您通过 Artisan 命令轻松更改 composer.json 文件中的应用程序或包的版本。

假设您有一个应用程序或包，您希望确保 composer.json 中有正确的版本信息，您可以运行 php artisan bump来自动增加版本信息。

示例输出

unknown@Dell-Studio-1747:~/Code/ComposerBump$ php artisan bump
Bump from: 0.0.1 to 0.0.2
unknown@Dell-Studio-1747:~/Code/ComposerBump$

还提供了一个漂亮的 Facade，可以在关于页面或类似页面中使用，显示您的应用程序或包版本给客户。

有关版本信息的更多信息，请访问 http://semver.org/

给定版本号 MAJOR.MINOR.PATCH，在以下情况下增加版本号：

• MAJOR 版本号，当您进行不兼容的 API 变更时；
• MINOR 版本号，当您以向后兼容的方式添加功能时；
• PATCH 版本号，当您进行向后兼容的错误修复时。

用法

所有命令列表

php artisan bump:patch 增加 PATCH 版本号（major.minor.PATCH => version 0.0.1）

示例输出：增加版本：从 0.0.1 到 0.0.2

php artisan bump:minor 增加 MINOR 版本号（major.MINOR.patch => version 0.1.0）

示例输出：增加版本：从 0.0.2 到 0.1.0

php artisan bump:major 增加 MAJOR 版本号（MAJOR.minor.patch => version 1.0.0）

示例输出：增加版本：从 0.1.0 到 1.0.0

使用 Facade 支持

在您的控制器中，您可以轻松获取并返回应用程序或包的版本

`return ComposerBump::getVersion();`

安装

步骤 1：通过 Composer 安装

composer require talevskiigor/composer-bump

步骤 2：更新 config/app.php 并在 Service Provider 中插入以下行

Talevskiigor\ComposerBump\ComposerBumpServiceProvider::class,

步骤 3（可选）：添加 Facade 支持

'ComposerBump'=>Talevskiigor\ComposerBump\Facades\ComposerBump::class,

如果您只想将此包用于本地开发，则不需要更新 config/app.php。相反，您可以直接更新 app/Providers/AppServiceProvider.php 提供者，例如

public function register()
{
    if ($this->app->environment() == 'local') {
        $this->app->register('Talevskiigor\ComposerBump\ComposerBumpServiceProvider');
    }
}

步骤 4：运行新的 Artisan 命令

`php artisan bump` - this is alias of `bump:patch`

有用信息

该包将在每次使用时备份您的 composer.json 文件，因此您可以轻松地撤销更改，简单使用撤销命令

`php artisan bump:undo`

示例输出

!!! WARNING !!!!!! WARNING !!!!!! WARNING !!!
    This will replace content of: composer.json file with content from file: composer.json-backup   !!!

 Are you suere? [y|N] (yes/no) [no]:
 > yes

Restored file: composer.json-backup into file: composer.json

unknown@Dell-Studio-1747:~/Code/ComposerBump$

贡献

为任何新功能或更改的功能添加单元测试。使用 PHPUnit 检查并测试您的代码。

1. 创建分支
2. 切换到 develop 分支（git checkout develop）
3. 创建您的功能分支（git checkout -b my-new-feature）
4. 提交您的更改（git commit -am 'Add some feature'）
5. 将分支推送到远程（git push origin my-new-feature）
6. 创建新的 Pull Request
7. 感谢

许可证

版权所有 (c) MIT 许可证。