swatty007/laravel-versioning-helper

Versioning Helper to handle Versioning within Laravel applications.

2.0.0 2023-09-26 15:43 UTC

Requires

• php: ^8.1
• illuminate/support: ^9.0|^10.0
• phlak/semver: ^4.0.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^2.18|^3
• orchestra/testbench: ^v8.0.0
• phpmd/phpmd: @stable
• phpmetrics/phpmetrics: ^2.7
• phpunit/phpunit: ^10

MIT

• Martin Niehoff

• git
• semver
• versioning
• helper
• svn
• swatty007
• laravel-versioning-helper

README

The versioning helper package bundles a small set of helper functions & blade components, to make updating & rendering your applications version & build number an ease.

Its aims at helping you to keep your applications version number up to date & showcasing it within your applications to improve client feedback on support tickets. The package supposes that you are using SemVer to version your application.

Installation

You can install the package via composer:

composer require swatty007/laravel-versioning-helper

Configuration

After installing the package you can publish the configuration file via:

php artisan vendor:publish --provider="Swatty007\\LaravelVersioningHelper\\LaravelVersioningHelperServiceProvider"

It contains some optional configuration parameters and is fully documented.

Usage

Simply add the following component to the desired location of your view:

<x-versioning-helper-build-string></x-versioning-helper-build-string>

to display the full versioning information of your application, containing:

• Application Name
• Copyright Information
• Version Number

Alternatively you can also the following components separately, to display only a part of those information:

• x-versioning-helper-application-name
• x-versioning-helper-copyright
• x-versioning-helper-version

You can simply specify the current version of your application through our config file, or through a user definable Cache variable, which can be set/updated via our fully documented versioning artisan command.

php artisan versioning:helper --help

In addition to that the package will automatically try to look up the latest revision of our application from your repository system of choice & append it as build number to your version string. (Unless configured otherwise!)

This help to ensure the version numbers which is displayed for your users will always represent the state of its sourcecode, even if you forget to correctly increase your version number. Which helps debugging issues which some in via support tickets!

Testing

Always appreciated 😎

composer test

Changelog

Please see CHANGELOG for more information what has changed recently.

TODO

• Currently None

Pull Requests are welcome 🧐

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

Credits

• Martin Niehoff
• All Contributors

License

The MIT License (MIT). Please see License File for more information.