A helper to get the current git version of the application
A helper class to get the current git version of the project.
Expects either a
version file to exist in the
base_path() of your project
containing a version string, or the
git binary to be available.
This package works with both Laravel 4 and 5, and also Lumen.
Require it in your Laravel/Lumen project:
composer require tremby/laravel-git-version
This module uses Symfony's Process component if available,
or falls back to
So if your deployment environment has
you can work around this by installing
You can get the git version string with
Or you can get your app name and version number such as
The app's name is taken from
Config::get('app.name', 'app'), so you can
configure it in your
config/app.php file or leave it as the default of
Ensure your git tags are pushed to your servers so that the versions are described properly.
During development and possibly in staging environments
allow the version to be determined automatically
(this is done via
As part of your production deployment procedure,
version file (perhaps via a command like
git describe --always --tags --dirty >version,
since this is the command this package would run otherwise).
version file exists the package will use its contents
rather than executing
git, saving some processor and IO time.
/version to your
so your working tree stays clean and you don't accidentally commit it.
A view is provided which just outputs an HTML comment with the return value of
getNameAndVersion(). I like to include this in the main layout template of the
To use this, install the service provider by adding it to your
'providers' => [ ... Tremby\LaravelGitVersion\GitVersionServiceProvider::class, ],
Then the view is available: