PHPackages                             nepada/envy - 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. [Validation & Sanitization](/categories/validation)
4. /
5. nepada/envy

AbandonedArchivedLibrary[Validation & Sanitization](/categories/validation)

nepada/envy
===========

Helpers for extracting, validating and type-casting data from environment variables

v1.3.1(3y ago)1204BSD-3-ClausePHPPHP >=7.4 <8.2

Since Oct 29Pushed 3y ago1 watchersCompare

[ Source](https://github.com/nepada/envy)[ Packagist](https://packagist.org/packages/nepada/envy)[ RSS](/packages/nepada-envy/feed)WikiDiscussions master Synced 6d ago

READMEChangelog (5)Dependencies (13)Versions (8)Used By (0)

Envy
====

[](#envy)

[![Build Status](https://github.com/nepada/envy/workflows/CI/badge.svg)](https://github.com/nepada/envy/actions?query=workflow%3ACI+branch%3Amaster)[![Coverage Status](https://camo.githubusercontent.com/d5e5a850c846a459c68e701d61540c81215bbd4c5ca6b602daa96306b984cff5/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f6e65706164612f656e76792f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/nepada/envy?branch=master)[![Downloads this Month](https://camo.githubusercontent.com/a61888932ab8b7636708c767ca326331004d43764e8491f73677ffe616bcc13c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f6e65706164612f656e76792e737667)](https://packagist.org/packages/nepada/envy)[![Latest stable](https://camo.githubusercontent.com/196ea9566574323ed96c85ebe5c26900de798c5e7f6c5979ef8ca97c8e861b70/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e65706164612f656e76792e737667)](https://packagist.org/packages/nepada/envy)

This package was originally developed and published under [damejidlo organization](https://github.com/damejidlo).

Package abandoned
-----------------

[](#package-abandoned)

**This package is considered abandoned.**

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

[](#installation)

```
$ composer require nepada/envy
```

Basic usage
-----------

[](#basic-usage)

Create `Envy instance`:

```
use Nepada\Envy\Envy;
use Nepada\Envy\LoaderFactory;
use Nepada\Envy\ValueProviders\Reader;

$reader = new Reader();
$loaderFactory = new LoaderFactory($reader);
$envy = new Envy($reader, $loaderFactory);
```

`Envy` supports several methods for loading the most common data types from env variables. When loading the value, it is first validated (throws exception on invalid input), and then type-casted.

### String values

[](#string-values)

```
// Get string from `FOO` env variable, or throw exception if not set
$envy->getString('FOO');
// Get string from `FOO` env variable, or return `'default'` if not set
$envy->getString('FOO', 'default');
// Get string from `FOO` env variable, or return `NULL` if not set
$envy->getStringOrNull('FOO');
```

### Boolean values

[](#boolean-values)

There are multiple supported ways of expressing boolean values: `true`/`false`, `yes`/`no`, `1`/`0` (all case insensitive).

```
// Get boolean from `FOO` env variable, or throw exception if not set
$envy->getBool('FOO');
// Get boolean from `FOO` env variable, or return `FALSE` if not set
$envy->getBool('FOO', FALSE);
// Get boolean from `FOO` env variable, or return `NULL` if not set
$envy->getBoolOrNull('FOO');
```

### Integer values

[](#integer-values)

```
// Get integer from `FOO` env variable, or throw exception if not set
$envy->getInt('FOO');
// Get integer from `FOO` env variable, or return `42` if not set
$envy->getInt('FOO', 42);
// Get integer from `FOO` env variable, or return `NULL` if not set
$envy->getIntOrNull('FOO');
```

### Float values

[](#float-values)

```
// Get float from `FOO` env variable, or throw exception if not set
$envy->getFloat('FOO');
// Get float from `FOO` env variable, or return `3.1415` if not set
 $envy->getFloat('FOO', 3.1415);
// Get float from `FOO` env variable, or return `NULL` if not set
$envy->getFloatOrNull('FOO');
```

### Arrays

[](#arrays)

The default item delimiter `~\s*,\s*~` is used to split the items.

#### List of string values

[](#list-of-string-values)

```
// Get array of string from `FOO` env variable, or throw exception if not set
$envy->getStringArray('FOO');
// Get array of strings from `FOO` env variable, or return `['foo']` if not set
$envy->getStringArray('FOO', ['foo']);
// Get array of strings from `FOO` env variable, or return `NULL` if not set
$envy->getStringArrayOrNull('FOO');
```

#### List of integer values

[](#list-of-integer-values)

```
// Get array of integer from `FOO` env variable, or throw exception if not set
$envy->getIntArray('FOO');
// Get array of integers from `FOO` env variable, or return `[42]` if not set
$envy->getIntArray('FOO', [42]);
// Get array of integers from `FOO` env variable, or return `NULL` if not set
$envy->getIntArrayOrNull('FOO');
```

#### List of float values

[](#list-of-float-values)

```
// Get array of float from `FOO` env variable, or throw exception if not set
$envy->getFloatArray('FOO');
// Get array of float from `FOO` env variable, or return `[3.1415]` if not set
$envy->getFloatArray('FOO', [3.1415]);
// Get array of float from `FOO` env variable, or return `NULL` if not set
$envy->getFloatArrayOrNull('FOO');
```

Nette DI integration
--------------------

[](#nette-di-integration)

Register the extension in your configuration, this will register the necessary services in your DI container:

```
extensions:
    envy: Nepada\Bridges\EnvyDI\EnvyExtension
```

You can now use a shorthand notation to access `Envy` methods:

```
parameters:
    loadedFromEnvVariables:
        foo: @envy::getString('FOO')
        bar: @envy::getIntArray('FOO', [1, 1, 2, 3, 5, 8, 13])

services:
    -
        type: MyService
        arguments:
            foo: %loadedFromEnvVariables.foo%
            bar: %loadedFromEnvVariables.bar%
```

Custom loaders
--------------

[](#custom-loaders)

You can create your own loaders with completely customizable processing of loaded values, e.g.:

```
use Nepada\Envy\LoaderFactory;
use Nepada\Envy\ValueProviders\Reader;

$reader = new Reader();
$loaderFactory = new LoaderFactory($reader);

$defaultValue = ['https://example.com'];

// Processor that will split items on semicolon and validate every item contains valid URL
$arrayProcessor = (new ArrayProcessor())
	->withDelimiter('~;~')
	->withItemValidator('url');

$loader = $loaderFactory->createLoader()
	->withAddedProcessor($arrayProcessor)
	->withValidator('array:1..') // make sure we're loading non-empty array
	->withFallback($defaultValue);

// Get non-empty list of URLs from `FOO_URLS` env variable, or `$defaultValue` if not set
$urls = $loader->get('FOO_URLS');
```

If the default set of processors does not cover your use case, you can write your own by implementing `ProcessorInterface`.

Validation
----------

[](#validation)

The validation is build on top of `Nette\Utils\Validators` - you can validate against any type Nette supports.

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity75

Established project with proven stability

 Bus Factor1

Top contributor holds 50% 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 ~175 days

Recently: every ~243 days

Total

7

Last Release

1342d ago

Major Versions

v0.1.1 → v1.0.02020-01-15

PHP version history (3 changes)v0.1.0PHP >=7.3

v1.1.0PHP >=7.4

v1.3.1PHP >=7.4 <8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/5b4780fe328102c4572737db639653c29d3081d1d3e051467f00d7f09a776399?d=identicon)[xificurk](/maintainers/xificurk)

---

Top Contributors

[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (66 commits)")[![xificurk](https://avatars.githubusercontent.com/u/117465?v=4)](https://github.com/xificurk "xificurk (66 commits)")

---

Tags

configurationnetteenv

###  Code Quality

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/nepada-envy/health.svg)

```
[![Health](https://phpackages.com/badges/nepada-envy/health.svg)](https://phpackages.com/packages/nepada-envy)
```

###  Alternatives

[nette/schema

📐 Nette Schema: validating data structures against a given Schema.

1.0k336.4M125](/packages/nette-schema)[nette/forms

📝 Nette Forms: generating, validating and processing secure forms in PHP. Handy API, fully customizable, server & client side validation and mature design.

54013.2M450](/packages/nette-forms)[uestla/recaptcha-control

reCAPTCHA control for Nette Framework forms

26572.0k1](/packages/uestla-recaptcha-control)[kdyby/validator

Integration of Symfony/Validator into Nette Framework

10128.1k4](/packages/kdyby-validator)[ipub/phone

Phone helper & validator for Nette Framework

1285.3k6](/packages/ipub-phone)[lionix/envclient

Laravel environment client and console commands.

1621.5k](/packages/lionix-envclient)

PHPackages © 2026

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