README

轻松管理您的 Laravel 应用版本

描述

使用此包，您可以

在页面上打印版本号；
通过 artisan 命令在控制台打印；
通过 artisan 命令递增版本号。

安装

通过 Composer

$ composer require j2nlab/laravel-simple-version

然后发布配置文件

$ php artisan vendor:publish --provider="J2Nlab\SimpleVersion\ServiceProvider"

初始的 config/version.php 是

<?php

return array (
  'major' => 0,
  'minor' => 0,
  'patch' => 0,
  'build' => false,
  'commit' => false,
);

如果构建为 false，则忽略此数字；否则，它递增且永远不会重置为 0。如果您想设置构建号，请设置任何值（例如 0 或 1）。

如果提交为 false，则忽略此数字；否则获取最后本地提交的前 6 个数字。如果您想设置提交号，请设置（例如 0 或 1）。

Artisan 命令

所有可用的命令如下

$ php artisan version         
$ php artisan version:major   
$ php artisan version:minor   
$ php artisan version:patch   
$ php artisan version:build   
$ php artisan version:commit

php artisan version

显示版本号，可通过辅助函数和 Blade 指令以不同的方式显示，目前有 'full' 和 'compact'（默认）。

$ php artisan version
Version (compact): 1.1.1-11-f44744
Version (full): version 1.1.1 (build: 11) (commit: f44744)

如果构建值为 false。

$ php artisan version
Version (compact): 1.1.1-f44744
Version (full): version 1.1.1 (commit: f44744)

如果构建和提交值都为 false。

$ php artisan version
Version (compact): 1.1.1
Version (full): version 1.1.1

如果补丁和构建值都为 false。

$ php artisan version
Version (compact): 1.1-f44744
Version (full): version 1.1 (commit: f44744)

php artisan version:commit

如果 config/version.php 中的提交值不是 false，则获取最后 git 本地提交的前 6 个数字。

$ php artisan version:commit
New commit number: db5a4a
New version: 1.1.1-9-db5a4a

如果提交值为 false。

$ php artisan version:commit
No commit number!

php artisan version:build

如果 config/version.php 中的构建值不是 false，则递增构建号。此数字永远不会重置为 0。

$ php artisan version:build
New build number: 12
New version: 1.1.1-12-db5a4a

如果构建值为 false。

$ php artisan version:build
No build number!

php artisan version:patch

如果 config/version.php 中的补丁值不是 false，则递增应用程序补丁号。

$ php artisan version:patch
New major version: 2
New version: 1.1.2-12-db5a4a

如果补丁值为 false。

$ php artisan version:patch
No patch number!

php artisan version:minor

递增应用程序次要版本号，并将补丁号重置为 0。

$ php artisan version:minor
New minor version: 2
New version: 1.2.0-12-db5a4a

php artisan version:major

递增应用程序主版本号，并将次要和补丁号重置为 0。

$ php artisan version:major
New major version: 2
New version: 2.0.0-12-db5a4a

总结...

非常简单

'major' => 0, 通过 version:major 递增
'minor' => 0, 通过 version:minor 递增，通过 version:major 重置为 0
'patch' => 0, 通过 version:patch 递增，通过 version:major/minor 重置为 0
'build' => 0, 通过 version:build 递增
'build' => false, 永远不会递增
'commit' => 0, 通过 version:commit 设置为最后 git 提交的前 6 个数字
'commit' => false, 永远不会获取

辅助函数

您可以使用此辅助函数获取紧凑的版本格式

$version = version();

或者您可以选择以下格式

$version = version('compact');
$version = version('full');

Blade 指令

您可以使用此指令渲染紧凑的版本格式

@version