PHPackages                             rtablada/version-master - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. rtablada/version-master

ActiveLibrary[Utility & Helpers](/categories/utility)

rtablada/version-master
=======================

A git based versioning tool for PHP projects with Laravel Service Providers

v1.1.0(10y ago)01.2k[1 issues](https://github.com/rtablada/version-master/issues)MITPHPPHP >=5.3.0

Since Oct 4Pushed 10y ago1 watchersCompare

[ Source](https://github.com/rtablada/version-master)[ Packagist](https://packagist.org/packages/rtablada/version-master)[ Docs](https://github.com/thephprtablada/version-master)[ RSS](/packages/rtablada-version-master/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (4)Versions (3)Used By (0)

version-master
==============

[](#version-master)

[![Latest Version on Packagist](https://camo.githubusercontent.com/100bc9bb83c4c429726f544b96c58fb7690c7f068015a55c0e4e5821e2db7a77/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f727461626c6164612f76657273696f6e2d6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/rtablada/version-master)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Build Status](https://camo.githubusercontent.com/57d17220e62649ad8649711c95a43a9fcb66617eb0ae6f275b67812a1db05c9a/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f746865706870727461626c6164612f76657273696f6e2d6d61737465722f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/thephprtablada/version-master)[![Coverage Status](https://camo.githubusercontent.com/f7f8d079931ab817fdceaa708f04fe4f38a4936de3bf975d22b7891c9a7ebc8c/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f636f7665726167652f672f746865706870727461626c6164612f76657273696f6e2d6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/thephprtablada/version-master/code-structure)[![Quality Score](https://camo.githubusercontent.com/c8fc0bdf4f6ded820a20c267800c023f140b6ee2192c13a64491acbc29cecc66/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f746865706870727461626c6164612f76657273696f6e2d6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/thephprtablada/version-master)[![Total Downloads](https://camo.githubusercontent.com/e9848f5e9609281e67332ad648b15f2095e4c1270ef45542e0c3f32642df97f9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f727461626c6164612f76657273696f6e2d6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/rtablada/version-master)

Version Master is a git based versioning tool for PHP projects with Laravel Service Providers. This package uses the `.git` storage file to read the current hash for the specified project or folder.

Since, the `GitHashReader` uses file access, it does not need to have access to the `git` command or `exec` privileges which may not be available in production environments.

Install
-------

[](#install)

Via Composer

```
$ composer require rtablada/version-master
```

Usage
-----

[](#usage)

The basic class for this package is the `GitHashReader`. It requires two arguments:

- `required` - An instance of `Illuminate\Filesystem` - Used to read from the Git File Tree
- `required` - A string path for the root of the git project.
- `optional` - A string path for the name of the git storage folder (defaults to `.git`)

```
$reader = new Rtablada\VersionMaster\GitHashReader();

echo $reader->getFullVersion(); // Outputs latest hash on git HEAD
```

Laravel Usage
-------------

[](#laravel-usage)

This package also includes a Service Provider to allow use in Laravel Applications.

This Service Provider acts in two ways:

- Registers a singleton so that `Rtablada\VersionMaster\GitHashReader` can be injected.
- Registers a `@version()` helper in Blade to output the short version number.

To install this Service Provider just add `Rtablada\VersionMaster\GitVersionProvider::class` in your `providers` array in `config/app.php`.

Change log
----------

[](#change-log)

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

Testing
-------

[](#testing)

```
$ composer test
```

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security
--------

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Ryan Tablada](https://github.com/rtablada)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 90.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

3879d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ea9ccd400c74151601341e320935a31d1a9779c5eb49a8f364bc7a0ac75baa32?d=identicon)[rtablada](/maintainers/rtablada)

---

Top Contributors

[![rtablada](https://avatars.githubusercontent.com/u/2532004?v=4)](https://github.com/rtablada "rtablada (10 commits)")[![thattomperson](https://avatars.githubusercontent.com/u/1112472?v=4)](https://github.com/thattomperson "thattomperson (1 commits)")

---

Tags

rtabladaversion-master

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/rtablada-version-master/health.svg)

```
[![Health](https://phpackages.com/badges/rtablada-version-master/health.svg)](https://phpackages.com/packages/rtablada-version-master)
```

###  Alternatives

[barryvdh/laravel-ide-helper

Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion.

14.9k123.0M687](/packages/barryvdh-laravel-ide-helper)[yajra/laravel-datatables-oracle

jQuery DataTables API for Laravel

4.9k33.8M339](/packages/yajra-laravel-datatables-oracle)[orchestra/canvas

Code Generators for Laravel Applications and Packages

20917.2M158](/packages/orchestra-canvas)[illuminate/session

The Illuminate Session package.

9937.4M753](/packages/illuminate-session)[genealabs/laravel-changelog

A Laravel Nova tool.

55250.7k](/packages/genealabs-laravel-changelog)[flarum/core

Delightfully simple forum software.

211.3M1.9k](/packages/flarum-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)