Componette

Componette

mallgroup

mallgroup / environment-adapter v1.2.0

Simple mallgroup/environment adapter for Nette framework

download-cloud-line composer require mallgroup/environment-adapter

Mallgroup/Environment-adapter

Adapter for Nette so you can use *.env config files.

Coverage Status Build Status Downloads this Month Scrutinizer Code Quality Latest stable License

Installation

The best way to install Mallgroup/Environment-adapter is using Composer:

$ composer require mallgroup/environment-adapter

Development

This package is currently maintaining by these authors.

How to use

For use this adapter, you need to use Mallgroup/Configurator instead of Nette one. It will autoregister ENV extension support. After that, you can simply link some-name.env file and nette will inject env variables into %env%. The expected syntax is name_of_env_variable: ::{string|int|float|bool}(default: {string}, hidden: {true|false}) name_of_array_variable: ::array(separator: {string}, hidden: {true|false}, cast: {int|float|bool|string})

first entry is name of ENV variable, this will add %env.name_of_env_variable% to the parameters and get value using getenv('NAME_OF_ENV_VARIABLE'); next is :: that will tell adapter, we are working with entity, this is just shortcut to force nette get arguments using internal mechanism. after that, we have cast part, this tells adapter, what type of variable he should cast to, usefull as env know only strings, with this, you can have INTs, FLOATs, BOOLs and even ARRAY of INT, FLOAT, STRING, BOOL.

attributes inside

default: that is fallback, if no value is found using getenv.
hidden: if variable must remain secret, or we can burn it into generated container file (if we have password, we do not want to have it stored in PHP file, but kept it in ENV only)
cast: only for Array, cast values to specific type
separator: only for Array, used for explode

if you keep order of arguments same as Environment class expect, you can omit their names.

Example file

service_user: ::string(secret_user)
service_password: ::string(secret_password, true)
service_port: ::int(1234)
service_nonstring: ::nonstring(1234)
service_active: ::bool(\'false\')
service_array: ::array(cast: int)

with .env

SERVICE_USER=someuser
SERVICE_PASSWORD=supersecret
SERVICE_ARRAY=1|2|3|4

will be translated to if none ENV

[
	'service_user' => 'someuser',
	'service_password' => Mallgroup\Environment::string('SERVICE_PASSWORD', 'secret_password'),
	'service_port' => 1234,
	'service_nonstring' => '1234',
	'service_active' => false # notice string false is translated to the boolean correctly
	'service_array' => [1,2,3,4],
]
  • v1.2.0 Released version v1.2.0

    Added PHP 8.2 support

  • v1.1.3 v1.1.3

    • added PHP8.1 support
  • v1.1.2 v1.1.2

    Fixed wrong appDir path

  • v1.1.1 v1.1.1

    Fixed cast was passed, when should not

  • v1.1.0 v1.1.0

  • v1.0.2 Released version v1.0.2

    • Simplified getDefaultParameters()
  • v1.0.1 Released version v1.0.1

  • v1.0.0 Released version v1.0.0

bar-chart-fill

Statistics

download-cloud-fill
14
star-fill
3
bug-fill
0
flashlight-fill
34d
price-tag-2-line

Badges

guide-fill

Dependencies

Componette Componette felix@nette.org