Stars: 569
Forks: 95
Pull Requests: 54
Issues: 57
Watchers: 15
Last Updated: 2022-11-16 09:36:13
Laravel App versioning
License: MIT License
Languages: PHP
This package is a Laravel (5.5+) utility which helps you keep and manage your application version, increment version numbers (major, minor, patch, commit), and can also use your last commit hash.
This package is able to parse a SemVer version:
v2.0.1-alpha.1227
And translate it to be used as:
label: v
major: 2
minor: 0
patch: 1
prerelease: alpha
buildmetadata: 1227
commit: 49ffe2
You can use the format function to rewrite and show it in your app, for instance, as:
MyApp version 2.0.1 - alpha 1227 (commit 49ffe2)
version:
current:
major: 1
minor: 0
patch: 0
format: '{$major}.{$minor}.{$patch}'
commit:
mode: number
number: 701036
Configure it
commit:
mode: git-local
And you may have an output like this
MyApp version 1.0.0 (commit a9c03f)
Or just use an incremental commit hash/number:
commit:
mode: number
number: 701036
To get
MyApp version 1.0.0 (commit 701036)
php artisan version:commit
Which should print the new version number
New commit: 701037
MyApp version 1.0.0 (commit 701037)
Available for all of them:
$ php artisan version:major
$ php artisan version:minor
$ php artisan version:patch
$ php artisan version:build
You can configure the :
format:
version: "{$major}.{$minor}.{$patch}"
full: "version {{'format.version'}} (commit {$commit})"
compact: "v{{'format.version'}}-{$commit}"
Those are the results for full
and compact
formats
MyApp version 1.0.0 (commit 701037)
MyApp v1.0.0-701037
It gives you access to dynamic methods:
Version::compact()
And should you create a new one:
format:
awesome: "awesome version {$major}.{$minor}.{$patch}"
It will also become callable:
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
If you prefer not to use the Façade:
dd(
Version::format()
);
The best ways to instantiate it are:
A simple PHP object instantiation:
$version = new \PragmaRX\Version\Package\Version();
dd(
$version->format()
);
Or to get an already instantiated Version object from the container:
dd(
app(\PragmaRX\Version\Package\Version::class)->format()
);
But you have to make sure you published the config file
You can use this directive to render a full version format:
@version
Or choose the format:
@version('full')
@version('compact')
You can configure the directive name:
blade_directive: printversion
Then
@printversion('compact')
You can use your git tags as application versions, all you need is to set the version source to "git":
version_source: git
And if you add a commit hash/number to your tags:
$ git tag -a -f v0.1.1.3128
Version will use it as your app commit hash/number
You probably only need to change the git version matcher
git:
...
version:
matcher: "/[V|v]*[ersion]*\\s*\\.*(\\d+)\\.(\\d+)\\.(\\d+)\\.*(\\w*)/"
So let's say you tag your releases as
2017120299
YYYYMMDD##
You can change your matcher to
git:
version:
matcher: "/(\d{4})(\d{2})(\d{2})(?:\d{2})/"
And remove dots from your formats:
format:
compact: "v{$major}{$minor}{$patch}-{$commit}"
Here's a community example on how to send the app version number when logging an exception to 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);
}
}
}
This package also lets you absorb the last commit timestamp or store the current date to the version.yml file. This is the format in the config file:
timestamp:
year:
month:
day:
hour:
minute:
second:
timezone:
To absorb you only need to configure mode: absorb
then execute:
php artisan version:absorb
But you can also set mode: increment
then execute:
php artisan version:timestamp
To store the current date and time to the config file:
$ php artisan version:minor
New timestamp: 2019-09-16 18:23:03
MyApp version 2.3.2 (commit 49ffe2)
And you can then use it to show in your app:
Version::format('timestamp-full')
Those are the commands you have at your disposal:
Show the current app version:
$ 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
You need to set mode: absorb
.
Version can absorb git version and commit to the config file, so you can delete the .git folder and still keep your version and commit for fast access. You have to configure git_absorb
in your config file:
commit:
#...
git_absorb: git-local # "false", "git-local" or "git-remote"
And run it
$ php artisan version:absorb
The usual configuration setup to implement absorb is:
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
You need to set mode: increment
.
Increment the version item:
$ php artisan version:minor
New minor version: 5
MyApp version 1.5.0 (commit 701045)
This is the current regex used to break a version string:
^(?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-]+)*))?$
You can test it online: https://regex101.com/r/Ly7O1x/42
Via Composer
$ composer require pragmarx/version
Then publish the configuration file you'll have to:
$ php artisan vendor:publish --provider="PragmaRX\Version\Package\ServiceProvider"
And you should be good to use it in your views:
@version
As git versions are cached, you can tell composer to refresh your version numbers every time an update or install occur, by adding the refresh command to post-autoload-dump
:
"post-autoload-dump": [
...
"@php artisan version:refresh"
]
[Optional] You may also can automated this process by set inside your .git/hooks/post-commit
. It will automatic run the command once you have make a commit.
#!/bin/sh
php artisan version:refresh
If you are using Git commits on your commit numbers, you may have to add the git repository to your .env file
VERSION_GIT_REMOTE_REPOSITORY=https://github.com/antonioribeiro/version.git
If you are using git-local
make sure the current folder is a git repository
$ composer test
rm -rf vendor
rm composer.lock
composer install
This package is licensed under the MIT License - see the LICENSE
file for details
Pull requests and issues are welcome.