avto-dev/app-version-laravel

Laravel applications versioning

, _(*1)

AppVersion for Laravel applications

![PHP Version][badge_php_version] ![Coverage][badge_coverage] ![License][badge_license], _(*2)

, _(*3)

Picture taken from antonioribeiro/version repository, _(*4)

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

Install

Require this package with composer using the following command:, _(*6)

$ composer require avto-dev/app-version-laravel "^3.0"

Installed composer is required (how to install composer)., _(*7)

You need to fix the major version of package., _(*8)

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

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

Usage

This package provides application version manager (AppVersionManager) and:, _(*10)

• 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)., _(*11)

Built-in "storage" types:, _(*12)

• 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:, _(*13)

<?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

Blade

Blade compiler allows next directives:, _(*14)

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

Testing

For package testing we use phpunit framework and docker with compose plugin as develop environment. So, just write into your terminal after repository cloning:, _(*15)

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

Changes log

![Commits since latest release][badge_commits_since_release], _(*16)

Changes log can be found here., _(*17)

Support

![Issues][badge_pulls], _(*18)

If you will find any package errors, please, make an issue in current repository., _(*19)

License

This is open-sourced software licensed under the MIT License., _(*20)