ekoukltd/version

掌握您Laravel应用程序版本的控制权

维护者

详细信息

github.com/ekoukltd/version

源代码

安装次数: 3,029

依赖项: 0

建议者: 0

安全性: 0

星标: 0

关注者: 0

分支: 102

1.3.1 2022-05-28 15:05 UTC

Requires

Requires (Dev)

MIT a05025de8a643bacce0d6ee33c00acb23990a7b0

  • Antonio Carlos Ribeiro <acr.woop@antoniocarlosribeiro.com>

versionversioninglaravel

This package is auto-updated.

Last update: 2024-08-28 20:00:34 UTC

README

掌握您Laravel应用程序版本的控制权

Latest Stable Version License Code Quality Build

Coverage StyleCI Downloads

描述

此包是Laravel (5.5+) 工具包，可以帮助您保持和管理应用程序版本，增加版本号（主要、次要、补丁、提交），还可以使用您的最后一个提交哈希值。

此包的最终结果是

  • 在页面上打印版本号。
  • 在控制台打印，通过Artisan命令。

全SemVer兼容性

此包能够解析SemVer版本

v2.0.1-alpha.1227

并将其转换为

label: v
major: 2
minor: 0
patch: 1
prerelease: alpha
buildmetadata: 1227
commit: 49ffe2

您可以使用格式化函数来重写并在应用程序中显示，例如

MyApp version 2.0.1 - alpha 1227 (commit 49ffe2)

这些结果的使用案例可能包括

  • 确保回滚成功。
  • 知道更新是否已达到所有服务器。
  • 检查用户是否正在查看您的应用程序的最新版本。
  • 验证Travis CI是否正在测试它应该测试的版本。
  • 您只是喜欢对您的项目进行版本管理，并且喜欢在所有页面上看到它们？这也很好。 :)
  • 您的用例是什么？ 告诉我们！

功能

通过YAML配置文件轻松控制您的应用程序版本

version: 
    current:
        major: 1
        minor: 0
        patch: 0
        format: '{$major}.{$minor}.{$patch}'
    commit:
        mode: number
        number: 701036

使用您的Git提交作为应用程序的提交哈希/编号

配置它

commit:
    mode: git-local

然后您可能会得到这样的输出

MyApp version 1.0.0 (commit a9c03f)

或仅使用增量提交哈希/编号

commit:
    mode: number
    number: 701036

以获取

MyApp version 1.0.0 (commit 701036)

使用Artisan命令轻松增加版本号

php artisan version:commit

它应该打印新版本号

New commit: 701037
MyApp version 1.0.0 (commit 701037)

适用于所有这些

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

输出格式高度可配置

您可以配置

format:
  version: "{$major}.{$minor}.{$patch}"
  full: "version {{'format.version'}} (commit {$commit})"
  compact: "v{{'format.version'}}-{$commit}"

以下是full和compact格式的结果

MyApp version 1.0.0 (commit 701037)
MyApp v1.0.0-701037

它为您提供了对动态方法的访问

Version::compact()

如果您创建了一个新的方法

format:
  awesome: "awesome version {$major}.{$minor}.{$patch}"

它也将可调用

Version::awesome()

提供了一个门面

Version::version() // 1.2.25

Version::commit() // 703110

Version::major() // 1

Version::minor() // 2

Version::patch() // 25

Version::format('full') // version 1.0.0 (commit 703110)

Version::full() // version 1.0.0 (commit 703110) -- dynamic method

Version::format('compact') // v.1.0.0-703110

Version::compact() // v.1.0.0-703110 -- dynamic method

实例化它

如果您不想使用门面

dd(
    Version::format()
);

实例化的最佳方式是

简单的PHP对象实例化

$version = new \PragmaRX\Version\Package\Version();

dd(
    $version->format()
);

或从容器中获取已实例化的Version对象

dd(
    app(\PragmaRX\Version\Package\Version::class)->format()
);

但是您必须确保您已发布配置文件

Blade指令也准备好在视图中使用

您可以使用此指令来渲染完整的版本格式

@version

或选择格式

@version('full')
@version('compact')

您可以配置指令名称

blade_directive: printversion

然后

@printversion('compact')

Git标签

您可以使用您的Git标签作为应用程序版本，您需要做的只是将版本源设置为"git"

version_source: git

并且如果您在标签中添加了提交哈希/编号

$ git tag -a -f v0.1.1.3128

版本将使用它作为您的应用程序提交哈希/编号

匹配其他版本（Git标签）格式

您可能只需要更改git版本匹配器

git:
  ...
  version:
    matcher: "/[V|v]*[ersion]*\\s*\\.*(\\d+)\\.(\\d+)\\.(\\d+)\\.*(\\w*)/"

所以让我们假设您按以下方式标记您的发布

2017120299
YYYYMMDD##

您可以将您的匹配器更改为

git:
  version:
    matcher: "/(\d{4})(\d{2})(\d{2})(?:\d{2})/"

并从格式中删除点

format:
  compact: "v{$major}{$minor}{$patch}-{$commit}"

在代码中使用当前应用程序版本

这是一个社区示例，说明如何在记录异常到Bugsnag时发送应用程序版本号

<?php

namespace App\Exceptions;

use PragmaRX\Version\Package\Version;
use Bugsnag\BugsnagLaravel\Facades\Bugsnag;

class Handler extends ExceptionHandler
{
    public function report(Exception $exception)
    {
        if ($this->shouldReport($exception)) {
            Bugsnag::setAppVersion((new Version())->format('version'));
            Bugsnag::notifyException($exception);
        }
    }
}

提交时间戳

此包还允许您吸收最后一个提交的时间戳或将当前日期存储到version.yml文件中。这是配置文件中的格式

timestamp:
  year:
  month:
  day:
  hour:
  minute:
  second:
  timezone:

要吸收，只需配置mode: absorb然后执行

php artisan version:absorb

但是您也可以设置mode: increment然后执行

php artisan version:timestamp

将当前日期和时间存储到配置文件中

$ php artisan version:minor
New timestamp: 2019-09-16 18:23:03
MyApp version 2.3.2 (commit 49ffe2)

然后您可以使用它来在您的应用中显示

Version::format('timestamp-full')

工匠命令

这些是您可用的命令

版本：显示

显示当前应用版本

$ php artisan version:show
PragmaRX version 1.0.0 (build 701031)

$ php artisan version:show --format=compact
PragmaRX v1.0.0-701031

$ php artisan version:show --format=compact --suppress-app-name
v1.0.0-701031

版本：吸收

您需要设置 模式：吸收。

版本可以吸收git版本和提交到配置文件，因此您可以删除.git文件夹，同时保留版本和提交以便快速访问。您必须在配置文件中配置git_absorb

commit:
  #...  
  git_absorb: git-local # "false", "git-local" or "git-remote"

然后运行它

$ php artisan version:absorb

实现吸收的常用配置设置

version_source: config             ## must be set as config
current:
    major: 1                       ## |
    minor: 0                       ## | --> will be changed by absorb
    patch: 0                       ## |
    git_absorb: git-local          ## configure to get from local or remote
commit:
    mode: number                   ## must be set as number
    number: f477c8                 ## will be changed by absorb
    git_absorb: git-local          ## configure to get from local or remote

版本：(主要|次要|补丁|提交)

您需要设置 模式：增量。

增加版本项

$ php artisan version:minor
New minor version: 5
MyApp version 1.5.0 (commit 701045)

正则表达式匹配器

这是当前用于分割版本字符串的正则表达式

^(?P<label>[v|V]*[er]*[sion]*)[\.|\s]*(?P<major>0|[1-9]\d*)\.(?P<minor>0|[1-9]\d*)\.(?P<patch>0|[1-9]\d*)(?:-(?P<prerelease>(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+(?P<buildmetadata>[0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$

您可以在网上测试它： https://regex101.com/r/Ly7O1x/42

安装

通过Composer

$ composer require pragmarx/version

然后发布您将拥有的配置文件

$ php artisan vendor:publish --provider="PragmaRX\Version\Package\ServiceProvider"

然后您应该可以使用它在您的视图中使用它

@version

由于git版本被缓存，您可以通过向post-autoload-dump中添加刷新命令，告诉composer在每次更新或安装时刷新版本号

"post-autoload-dump": [
    ...
    "@php artisan version:refresh"
]

[可选] 您还可以通过设置在.git/hooks/post-commit中来自动化此过程。一旦您提交，它将自动运行命令。

#!/bin/sh

php artisan version:refresh

如果您在使用Git提交的提交号，您可能需要在.env文件中添加git存储库

VERSION_GIT_REMOTE_REPOSITORY=https://github.com/antonioribeiro/version.git

如果您使用git-local，请确保当前文件夹是git存储库

最低要求

  • Laravel 5.5
  • PHP 7.0

测试

$ composer test

故障排除

  • 如果您因为symfony/router (3.3/3.4) 或 symfony/yaml (3.3/3.4) 而无法安装，您可以尝试
rm -rf vendor
rm composer.lock
composer install

作者

Antonio Carlos Ribeiro

许可

本软件包根据MIT许可证授权 - 有关详细信息，请参阅LICENSE文件

贡献

欢迎拉取请求和问题。