PHPackages                             ezermeno/fmx-version-app - 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. ezermeno/fmx-version-app

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

ezermeno/fmx-version-app
========================

Expose Laravel application version based on build-time Git commit (runtime-safe and config-cache friendly).

v1.0.0(1mo ago)04MITPHPPHP ^8.1

Since May 2Pushed 1mo agoCompare

[ Source](https://github.com/ezermeno/fmx-version-app)[ Packagist](https://packagist.org/packages/ezermeno/fmx-version-app)[ RSS](/packages/ezermeno-fmx-version-app/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (1)Versions (2)Used By (0)

FMX Version App
===============

[](#fmx-version-app)

[![Packagist Version](https://camo.githubusercontent.com/0dbc9b09373aec5afe45dafae3582888f92c8c55d771fad0e54d9ec06fb3b196/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f657a65726d656e6f2f666d782d76657273696f6e2d617070)](https://packagist.org/packages/ezermeno/fmx-version-app)[![Total Downloads](https://camo.githubusercontent.com/ab7890ceb82387e373dbb52d9321f4a5ad2ecb1c90b855b177e626365e08be43/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f657a65726d656e6f2f666d782d76657273696f6e2d617070)](https://packagist.org/packages/ezermeno/fmx-version-app)[![PHP Version Require](https://camo.githubusercontent.com/dc0f8a572a9537891870bfb2719afe25057cdde66d5d1463713746495a97d799/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f657a65726d656e6f2f666d782d76657273696f6e2d617070)](https://packagist.org/packages/ezermeno/fmx-version-app)[![License](https://camo.githubusercontent.com/f75cc148b1f6f2e7697d2ec652e006d08a08de0f82993754e0ee3f381d2857e0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f657a65726d656e6f2f666d782d76657273696f6e2d617070)](https://packagist.org/packages/ezermeno/fmx-version-app)

[![Laravel](https://camo.githubusercontent.com/934c60d4b198c50fe53587c7ef11138695a83b6f668b40ef8f995dab4ac7b805/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d3130253230253743253230313125323025374325323031322d726564)](https://camo.githubusercontent.com/934c60d4b198c50fe53587c7ef11138695a83b6f668b40ef8f995dab4ac7b805/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d3130253230253743253230313125323025374325323031322d726564)

Un paquete para Laravel que permite **exponer la versión de una aplicación basada en el commit de Git**, de forma **segura para producción** y totalmente compatible con `config:cache`.

> ✅ Git se utiliza **solo en build-time**
> ❌ Nunca se ejecuta Git en runtime

---

✨ Características
-----------------

[](#-características)

- ✅ Versión basada en el commit actual
- ✅ Seguro para producción (no depende de `.git`)
- ✅ Compatible con `config:cache`
- ✅ Ideal para CI/CD, Docker, Forge y Vapor
- ✅ Incluye comandos Artisan
- ✅ Facade listo para usar

---

📦 Instalación
-------------

[](#-instalación)

Instala el paquete vía Composer:

```
composer require ezermeno/fmx-version-app
```

Laravel registrará automáticamente el service provider mediante auto‑discovery.

⚙️ Publicar configuración (opcional)

```
php artisan vendor:publish --tag=config
```

Esto publicará el archivo de configuración:

```
config/fmx-version-app.php
```

🚀 Generar la versión desde Git (build-time)

Este comando obtiene el commit actual de Git y actualiza la versión configurada de la aplicación.

```
php artisan fmxvapp:update
```

⚠️ Este comando debe ejecutarse solo en local, CI o durante el deploy, nunca en runtime.

Uso recomendado en CI/CD

```
php artisan fmxvapp:update
php artisan config:clear
php artisan config:cache

```

🖥️ Ver la versión por consola

```
php artisan fmxvapp:version
```

Ejemplo de salida:

```
Version: a3f91c2
Build at: 2026-04-30T05:41:00Z

```

🧩 Uso dentro de la aplicación

Mediante Facade

```
use Ezermeno\FmxVersionApp\Facades\FmxVersionApp;

FmxVersionApp::version();
FmxVersionApp::buildAt();
FmxVersionApp::toArray();
```

Resultado:

```
[
    'version' => 'a3f91c2',
    'build_at' => '2026-04-30T05:41:00Z',
];
```

Desde la configuración

```
config('fmx-version-app.version');
config('fmx-version-app.build_at');
```

📡 Ejemplo de endpoint API

```
use Ezermeno\FmxVersionApp\Facades\FmxVersionApp;

Route::get('/version', function () {
    return response()->json(FmxVersionApp::toArray());
});

```

Respuesta:

```
{
  "version": "a3f91c2",
  "build_at": "2026-04-30T05:41:00Z"
}

```

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance92

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 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.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

39d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/466772bd5ef85ee5f3217d60a1369aed348bbba7b770c87b9ceae5967748567a?d=identicon)[Enrique Zermeño](/maintainers/Enrique%20Zerme%C3%B1o)

---

Top Contributors

[![ezermeno](https://avatars.githubusercontent.com/u/20936136?v=4)](https://github.com/ezermeno "ezermeno (2 commits)")

---

Tags

laravelgitversionbuildcommitci-cd

### Embed Badge

![Health badge](/badges/ezermeno-fmx-version-app/health.svg)

```
[![Health](https://phpackages.com/badges/ezermeno-fmx-version-app/health.svg)](https://phpackages.com/packages/ezermeno-fmx-version-app)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3325.1M337](/packages/psalm-plugin-laravel)[renatomarinho/laravel-page-speed

Laravel Page Speed

2.5k1.7M11](/packages/renatomarinho-laravel-page-speed)[vinkius-labs/laravel-page-speed

Laravel Page Speed

2.5k9.6k1](/packages/vinkius-labs-laravel-page-speed)[salehhashemi/laravel-intelli-git

An intelligent Git helper package for Laravel applications. It utilizes OpenAI's GPT to analyze your Git repository, providing features such as automatic generation of commit messages based on staged changes.

132.1k](/packages/salehhashemi-laravel-intelli-git)[tomshaw/electricgrid

A feature-rich Livewire package designed for projects that require dynamic, interactive data tables.

119.2k](/packages/tomshaw-electricgrid)

PHPackages © 2026

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