PHPackages                             flycorp/laravel-git-version - 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. flycorp/laravel-git-version

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

flycorp/laravel-git-version
===========================

A helper to get the current git version of the application

137PHP

Since Oct 23Pushed 4y ago1 watchersCompare

[ Source](https://github.com/FlyCorp/laravel-git-version)[ Packagist](https://packagist.org/packages/flycorp/laravel-git-version)[ RSS](/packages/flycorp-laravel-git-version/feed)WikiDiscussions main Synced 5d ago

READMEChangelogDependenciesVersions (1)Used By (0)

Laravel/Lumen project git version getter
========================================

[](#laravellumen-project-git-version-getter)

A helper class to get the current git version of the project.

Expects either a `version` file to exist in the `base_path()` of your project containing a version string, or the `git` binary to be available.

Framework version
-----------------

[](#framework-version)

This package works with both Laravel 4 and 5, and also Lumen.

Installation
------------

[](#installation)

Require it in your Laravel/Lumen project:

```
composer require flyCorp/laravel-git-version

```

### Optional packages

[](#optional-packages)

This module uses [Symfony's Process component](https://github.com/symfony/process) if available, or falls back to `shell_exec` otherwise. So if your deployment environment has `shell_exec` disabled, you can work around this by installing `symfony/process`.

Use
---

[](#use)

You can get the git version string with

```
\FlyCorp\LaravelGitVersion\GitVersionHelper::getVersion()

```

Or you can get your app name and version number such as `my-project/1.0` with

```
\FlyCorp\LaravelGitVersion\GitVersionHelper::getNameAndVersion()

```

Or you can get your app all commits with

```
\FlyCorp\LaravelGitVersion\GitVersionHelper::geLog()

```

The app's name is taken from `Config::get('app.name', 'app')`, so you can configure it in your `config/app.php` file or leave it as the default of `app`.

### Recommended usage pattern

[](#recommended-usage-pattern)

Ensure your git tags are pushed to your servers so that the versions are described properly.

During development and possibly in staging environments allow the version to be determined automatically (this is done via `git describe`).

As part of your production deployment procedure, write a `version` file (perhaps via a command like `git describe --always --tags --dirty >version`, since this is the command this package would run otherwise). When this `version` file exists the package will use its contents rather than executing `git`, saving some processor and IO time.

Add `/version` to your `.gitignore` file so your working tree stays clean and you don't accidentally commit it.

View
----

[](#view)

A view is provided which just outputs an HTML comment with the return value of `getNameAndVersion()`. I like to include this in the main layout template of the project.

To use this, install the service provider by adding it to your `config/app.php`file:

```
'providers' => [
    ...
    FlyCorp\LaravelGitVersion\GitVersionServiceProvider::class,
],

```

Then the view is available:

```
@include('git-version::version-comment')

```

###  Health Score

17

—

LowBetter than 6% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity28

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/2d4f7b17e2d6ad759c26781e67c667933b8c25acd7614d517f4254c7d24726a3?d=identicon)[FlyCorp](/maintainers/FlyCorp)

---

Top Contributors

[![FlyCorp](https://avatars.githubusercontent.com/u/70100216?v=4)](https://github.com/FlyCorp "FlyCorp (12 commits)")

### Embed Badge

![Health badge](/badges/flycorp-laravel-git-version/health.svg)

```
[![Health](https://phpackages.com/badges/flycorp-laravel-git-version/health.svg)](https://phpackages.com/packages/flycorp-laravel-git-version)
```

###  Alternatives

[envant/fireable

An elegant way to trigger events based on attributes changes

445793.9k3](/packages/envant-fireable)[dunglas/php-torcontrol

Tor control library

895.3k1](/packages/dunglas-php-torcontrol)[talevskiigor/composer-bump

Laravel artisan command to increment composer.json version.

1870.9k2](/packages/talevskiigor-composer-bump)[digitoimistodude/dude-most-read-posts

A developer-friendly plugin to count most read posts

162.4k](/packages/digitoimistodude-dude-most-read-posts)

PHPackages © 2026

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