apavliukov/app-version-laravel

Laravel applications versioning

v3.4.1 2023-03-04 15:52 UTC

Requires

• php: ^7.3 || ^8.0
• illuminate/container: ~6.0 || ~7.0 || ~8.0 || ~9.0 || ~10.0
• illuminate/contracts: ~6.0 || ~7.0 || ~8.0 || ~9.0 || ~10.0
• illuminate/support: ~6.0 || ~7.0 || ~8.0 || ~9.0 || ~10.0
• illuminate/view: ~6.0 || ~7.0 || ~8.0 || ~9.0 || ~10.0
• symfony/console: ^4.4 || ~5.0 || ~6.0

Requires (Dev)

• laravel/laravel: ~6.0 || ~7.0 || ~8.0 || ~9.0 || ~10.0
• mockery/mockery: ^1.4
• phpstan/phpstan: ~0.12.34
• phpunit/phpunit: ^8.5.4 || ^9.3

MIT

• Alexander Pavliukov

• version
• laravel

README

AppVersion for Laravel applications

Laravel 9 ready

Picture taken from antonioribeiro/version repository

Laravel does not have included mechanism for a working with application version, and this package can fix this flaw.

Install

Require this package with composer using the following command:

$ composer require apavliukov/app-version-laravel

After that you should "publish" configuration file (./config/version.php) using next command:

$ php artisan vendor:publish --provider="AvtoDev\\AppVersion\\ServiceProvider"

Usage

This package provides application version manager (AppVersionManager) and:

• Version value repositories (abstraction layer above version data)
• Repository drivers (also known as "factories" - they creates configured repository instance)

You can write your own implementations, and use them (only correct configuration is required).

Built-in "storage" types:

• Plain file with version definition;
• Application configuration file (version.config by default);
• CHANGELOG.md file (extracts last defined version value).

If you wanna get access to the version manager using DI - just request AvtoDev\AppVersion\AppVersionManagerInterface:

<?php

namespace App\Console\Commands;

use AvtoDev\AppVersion\AppVersionManagerInterface;

class SomeCommand extends \Illuminate\Console\Command
{
    /**
     * The console command name.
     *
     * @var string
     */
    protected $name = 'some:command';

    /**
     * Execute the console command.
     *
     * @param AppVersionManagerInterface $manager
     *
     * @return void
     */
    public function handle(AppVersionManagerInterface $manager): void
    {
        $manager->version(); // e.g.: 1.0.0-alpha2
    }
}

Artisan commands

Command signature	Description
version	Shows application version
version --get-segment=major/minor/patch/build	Shown only major/minor/patch/build version value
version --set-build=alpha2	Set build value alpha2
version --set-version=1.2.3-alpha	Complex version setter

Blade

Blade compiler allows next directives:

Application version: @app_version
Build version: @app_build
Application version hash: @app_version_hash

Testing

For package testing we use phpunit framework and docker-ce + docker-compose as develop environment. So, just write into your terminal after repository cloning:

$ make build
$ make latest # or 'make lowest'
$ make test

Changes log

Changes log can be found here.

Support

If you will find any package errors, please, make an issue in current repository.

License

This is open-sourced software licensed under the MIT License.