2017 © Pedro Peláez
 

module rbversion

App versioning for Zend Framework 2 applications

image

robertboloc/rbversion

App versioning for Zend Framework 2 applications

  • Friday, July 18, 2014
  • by robertboloc
  • Repository
  • 1 Watchers
  • 1 Stars
  • 1 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 1 Versions
  • 0 % Grown

The README.md

RbVersion

Build Status Scrutinizer Code Quality Code Coverage, (*1)

Application versioning for Zend Framework 2., (*2)

Table of contents

About

Use this module to integrate the application versioning into your development practices. It allows propagating the application version without changing multiple files with every release., (*3)

Use case:, (*4)

By appending the version number to your stylesheets and javascript include calls, you can make sure that the user always gets the version you intended (and not an old cached one)., (*5)


<link href="//website.com/style.css?v=<?= $this->rbVersion() ?>"/>



Installation

Configuration

The default configuration of the module can be found in the file config/module.config.php. To override the defaults, add your values under the rb_version key in the config/autoload/local.php file of your application, using the same structure as in the defaults., (*6)

Provider

The provider is the source of the version. Two providers are implemented at the moment: direct and file., (*7)

Direct

With this provider the version comes directly from the configuration array. An example of direct provider configuration:, (*8)

'rb_version' => array(
'provider' => array(
        'type' => 'direct',
        'number'=> '1.2.3',
        'name'=> 'Amazing',
    ),
)

File

With this provider the configuration comes from a php file located somewehere on the disk. The configuration for this provider is as follows:, (*9)

'rb_version' => array(
'provider' => array(
        'type' => 'file',
        'file'=> '/tmp/version.php',
    ),
)

The content of the version file should be similar to the following example:, (*10)

<?php

use RbVersion\Model\Version as RbVersion;

return new RbVersion('1.2.3', 'Amazing Antilope');

Usage

Both a view helper, and a controller plugin are available., (*11)

Call $this->rbVersion() inside a view or controller. This will return the numeric version. If you have defined a name for the version and want it to be appendend to the numeric value, use $this->rbVersion(true) which will return both the numeric version and the name of it concatenated by a space., (*12)

For example if your version is 1.2.3 Awesome Antilope calling $this->rbVersion() will return 1.2.3 and calling $this->rbVersion(true) will return 1.2.3 Awesome Antilope, (*13)

Roadmap

  • Add travis-CI integration
  • Add scrutinizer integration
  • Add more providers (git)
  • Release on packagist/composer

The Versions