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(2mo ago)04MITPHPPHP ^8.1

Since May 2Pushed 2mo 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 3w 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

35

—

LowBetter than 77% of packages

Maintenance84

Actively maintained with recent releases

Popularity3

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

84d 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

3345.3M347](/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.5k12.5k1](/packages/vinkius-labs-laravel-page-speed)[emargareten/inertia-modal

Inertia Modal is a Laravel package that lets you implement backend-driven modal dialogs for Inertia apps.

90142.9k](/packages/emargareten-inertia-modal)[wearepixel/laravel-cart

A cart implementation for Laravel

1374.8k](/packages/wearepixel-laravel-cart)[tomshaw/electricgrid

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

119.4k](/packages/tomshaw-electricgrid)

PHPackages © 2026

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