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(4mo ago)0480MITPHPPHP ^8.2

Since Mar 3Pushed 4mo 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 today

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

40

—

FairBetter than 86% of packages

Maintenance78

Regular maintenance activity

Popularity17

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity48

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

121d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/984800?v=4)[gruelas](/maintainers/gruelas)[@gruelas](https://github.com/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

[matomo/matomo

Matomo is the leading Free/Libre open analytics platform

21.7k38.9k](/packages/matomo-matomo)[illuminate/console

The Illuminate Console package.

13046.0M6.5k](/packages/illuminate-console)[jolicode/castor

A lightweight and modern task runner. Automate everything. In PHP.

54743.1k4](/packages/jolicode-castor)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M574](/packages/shopware-core)[whatsdiff/whatsdiff

See what's changed in your project's dependencies

771.2k](/packages/whatsdiff-whatsdiff)[open-dxp/opendxp

Content & Product Management Framework (CMS/PIM)

9421.6k61](/packages/open-dxp-opendxp)

PHPackages © 2026

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