PHPackages                             equidna/env-builder - 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. [CLI & Console](/categories/cli)
4. /
5. equidna/env-builder

ActiveLibrary[CLI & Console](/categories/cli)

equidna/env-builder
===================

CLI and PHAR tool to merge .env fragments and optionally deploy compiled .env files.

1.0.1(2mo ago)016MITPHPPHP ^8.2

Since Mar 3Pushed 2mo agoCompare

[ Source](https://github.com/EquidnaMX/env-builder)[ Packagist](https://packagist.org/packages/equidna/env-builder)[ RSS](/packages/equidna-env-builder/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (3)Versions (3)Used By (0)

env-builder
===========

[](#env-builder)

CLI en PHP 8.2+ para compilar múltiples fragmentos de entorno desde `./.env.d` en un único `.env`, con soporte de overlays `*.env.dev`, trazabilidad por bloque y despliegue remoto vía `scp`/`rsync`.

Estructura recomendada
----------------------

[](#estructura-recomendada)

```
.
├─ .env.d/
│  ├─ app.env
│  ├─ app.env.dev
│  └─ database.env
├─ bin/
│  └─ env-builder
├─ src/
│  ├─ Console/
│  ├─ Deploy/
│  ├─ Env/
│  ├─ Exception/
│  ├─ Laravel/
│  └─ Service/
├─ build.php
└─ composer.json

```

Instalación como paquete Composer (Laravel u otros proyectos PHP)
-----------------------------------------------------------------

[](#instalación-como-paquete-composer-laravel-u-otros-proyectos-php)

```
composer require equidna/env-builder
```

Comando binario:

```
vendor/bin/env-builder build --dev
```

En Laravel (opcional), también queda disponible como Artisan:

```
php artisan env-builder:build --dev
```

Uso CLI
-------

[](#uso-cli)

Compilar `.env.d` -> `.env`:

```
php bin/env-builder build
```

Compilar incluyendo overlays `*.env.dev`:

```
php bin/env-builder build --dev
```

Salida personalizada:

```
php bin/env-builder build --source=.env.d --output=.env.production
```

Compilar y desplegar por SSH:

```
php bin/env-builder build --dev --deploy="usuario@ip:/ruta/destino/.env"
```

Prueba E2E reproducible (`--dev` + prioridad de `app.env`/`app.env.dev`):

```
composer test:e2e
```

O ejecutando el binario directamente:

```
php bin/env-builder-e2e-test
```

El binario de prueba escribe su fixture en un directorio temporal del sistema (`%TEMP%/env-builder-e2e` en Windows).

Formato de salida compilada
---------------------------

[](#formato-de-salida-compilada)

El `.env` generado incluye trazabilidad por bloque:

```
### [app.env] ###
APP_NAME=MyApp

### [app.env.dev] ###
APP_DEBUG=true
```

Si una variable se redefine en un archivo posterior (incluyendo `.env.dev`), la última definición reemplaza la anterior y en el archivo compilado solo queda una entrada por clave.

Además, cuando existen, `app.env` y `app.env.dev` se procesan primero para que el archivo compilado comience con esos bloques.

Build de PHAR (distribución universal)
--------------------------------------

[](#build-de-phar-distribución-universal)

1. Instalar dependencias:

```
composer install --no-dev --optimize-autoloader
```

2. Compilar PHAR:

```
composer build:phar
```

3. Ejecutar el binario autónomo:

```
./dist/env-builder.phar build --dev
```

En Windows:

```
php .\dist\env-builder.phar build --dev
```

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance85

Actively maintained with recent releases

Popularity8

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity47

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

Every ~0 days

Total

2

Last Release

76d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/21aa1f99daa17783331e507c7fa7ffd1fb5d9e93450069209d2c43e6d5c8ca1a?d=identicon)[gruelas](/maintainers/gruelas)

---

Top Contributors

[![gruelasjr](https://avatars.githubusercontent.com/u/40619710?v=4)](https://github.com/gruelasjr "gruelasjr (3 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/equidna-env-builder/health.svg)

```
[![Health](https://phpackages.com/badges/equidna-env-builder/health.svg)](https://phpackages.com/packages/equidna-env-builder)
```

###  Alternatives

[illuminate/console

The Illuminate Console package.

12944.1M5.1k](/packages/illuminate-console)[crunzphp/crunz

Schedule your tasks right from the code.

2292.0M6](/packages/crunzphp-crunz)[crazywhalecc/static-php-cli

Build single static PHP binary, with PHP project together, with popular extensions included.

1.8k13.9k](/packages/crazywhalecc-static-php-cli)[madewithlove/license-checker

CLI tool to verify allowed licenses for composer dependencies

54449.8k21](/packages/madewithlove-license-checker)[statamic/cli

Statamic CLI Tool

7587.7k](/packages/statamic-cli)[civicrm/cv

CLI tool for CiviCRM

4219.8k](/packages/civicrm-cv)

PHPackages © 2026

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