Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lionix-team/envclient
Manage and validate environmental variables with artisan console commands and facades
https://github.com/lionix-team/envclient
dotenv env environment environment-variables laravel laravel-framework lionix
Last synced: 2 months ago
JSON representation
Manage and validate environmental variables with artisan console commands and facades
- Host: GitHub
- URL: https://github.com/lionix-team/envclient
- Owner: lionix-team
- Created: 2020-01-24T12:03:40.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2021-01-21T07:39:51.000Z (almost 4 years ago)
- Last Synced: 2024-10-09T16:24:12.910Z (3 months ago)
- Topics: dotenv, env, environment, environment-variables, laravel, laravel-framework, lionix
- Language: PHP
- Homepage:
- Size: 108 KB
- Stars: 16
- Watchers: 3
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# EnvClient for Laravel
Manage and validate environmental variables with artisan console commands, environmental rules and facades
## Installation
```
composer require lionix/envclient
```
## Breaking changes
### From 1.0.0 to 1.1.0
- To construct the `\Lionix\Envclient` use Laravel Service Container instead of plain construct.
## Artisan commands
| Signature | Description |
| ----------------------- | ------------------------------------------------- |
| `env:get {key}` | Prints .env variable value |
| `env:set {key} {value}` | Sets .env variable if validation rules are passed |
| `env:check` | Check all env variables for validness |
| `env:empty` | Print empty .env variables |
| `make:envrule {name}` | Create a new .env validation rules |
## Basic usage
Set an environment variable using `env:set` artisan command.
```
php artisan env:set EXAMPLE_ENV_VARIABLE 'example value'
```
The command will modify your environment file by replacing or adding the given key to it.
### Validate environment variables
If you want to apply validation rules to environmental variables before `env:set` command will modify the file you will have to publish command package configuration files.
```
php artisan vendor:publish --provider='Lionix\EnvClient\Providers\EnvClientServiceProvider' --tag='config'
```
The command will create `config/env.php`
```php
[
\App\Env\BaseEnvValidationRules::class
]
];
```
and `app/Env/BaseEnvValidationRules.php`
```php
'required|in:mysql,sqlite'
];
}
...
```
This way if you try to set an invalid value to the `DB_CONNECTION` variable with `env:set` command, the console will print out an error
```
$ php artisan env:set DB_CONNECTION SomeInvalidValue
The selected DB_CONNECTION is invalid.
```
If your environment file was modified you can run `env:check` command which will check all variables for validness and print out the results.
```
$ php artisan env:check
The selected DB_CONNECTION is invalid.
```
## Create a new environmental validation rules
### Run the `make:envrule` command
By default, the script will generate a class in `App/Env` namespace.
#### Example:
```
php artisan make:envrule DatabaseEnvRules
```
`app/Env/DatabaseEnvRules.php`
```php
'requried|in:mysql,sqlite,pgsql,sqlsrv'
'DB_HOST' => 'requried',
'DB_PORT' => 'requried|numeric',
'DB_DATABASE' => 'requried',
'DB_USERNAME' => 'requried',
'DB_PASSWORD' => 'requried'
];
}
...
```
### Apply the rules:
You can add the `DatabaseEnvRules` class to `env.php` configuration file at the `rules` key. That way all the rules specified in the class will affect package artisan commands.
`config/env.php`
```php
[
\App\Env\BaseEnvValidationRules::class
\App\Env\DatabaseEnvRules::class // <- our database rules
]
];
```
Or you can use `Lionix\EnvClient` Facade to validate the input with given validation rules:
```php
...
$client = app()->make(\Lionix\Envclient::class);
$client->useValidator(new \App\Env\DatabaseEnvRules())->update($databaseCredentials);
if ($client->errors()->isNotEmpty()) {
// handle errors
} else {
// success, the variables are updated
}
...
```
## Facades
### Lionix\EnvClient
#### Properties:
- protected **\$getter** : _Lionix\EnvClient\Interfaces\EnvGetterInterface_
- protected **\$setter** : _Lionix\EnvClient\Interfaces\EnvSetterInterface_
- protected **\$validator** : _Lionix\EnvClient\Interfaces\EnvValidatorInterface_
#### Methods:
- `void` : **\_\_construct()**
Create a new instance of EnvClient using default dependencies
- `self` : **useGetter(_Lionix\EnvClient\Interfaces\EnvGetterInterface_ \$getter)**
Set client getter dependency
- `self` : **useSetter(_Lionix\EnvClient\Interfaces\EnvSetterInterface_ \$setter)**
Set setter dependency
- `self` : **useValidator(_Lionix\EnvClient\Interfaces\EnvValidatorInterface_ \$validator)**
Set validator dependency merging current errors with the validator errors
- `array` : **all()**
Get all env variables from the environmental file
- `bool` : **has(_string \$key_)**
Check if the environmental file contains the key
- `mixed` : **get(_string \$key_)**
Get the env variable using the key (returns the output of `Illuminate\Support\Env` get method)
- `self` : **set(_array \$values_)**
Set the environmental variables at runtime if validation rules passed
- `self` : **save()**
Save previously set variables to the environmental file
- `self` : **update()**
If validation rules passed then set and save variables to the environmental file
- `bool` : **validate(_array_ \$values)**
Check values validness and retrieve passed status
- `Illuminate\Support\MessageBag` : **errors()**
Get all validation errors occurred during the class lifetime
### Lionix\EnvGetter
#### Methods:
- `void` : **\_\_construct()**
Create a new instance of EnvGetter
- `mixed` : **get(_string_ \$key)**
Get the env variable using the key (returns the output of `Illuminate\Support\Env` get method)
- `array` : **all()**
Get all env variables from the environmental file
- `bool` : **has(_string_ \$key)**
Check if the environmental file contains the key
### Lionix\EnvSetter
#### Properties:
- protected **\$variablesToSet** : _array_
#### Methods:
- `void` : **\_\_construct()**
Create a new instance of EnvSetter
- `void` : **set(_array_ \$values)**
Merge given values with variablesToSet property
- `void` : **save()**
Save all variables previously set by the set method to the environmental file
- protected `string` : **sanitize(_string_ \$value)**
Sanitize input values
### Lionix\EnvValidator
#### Properties:
- protected **\$errors** : _Illuminate\Support\MessageBag_
#### Methods:
- `void` : **\_\_construct()**
Create a new instance of EnvValidator
- `array` : **rules()**
Returns class validation rules
- `bool` : **validate(_array_ \$values)**
Validate given values
- `Illuminate\Support\MessageBag` : **errors()**
Get validator errors
- `void` : **mergeErrors(_Illuminate\Support\MessageBag_ \$errors)**
Merge given MessageBag with current errors
## Credits:
- [Stas Vartanyan](https://github.com/vaawebdev)
- [Lionix Team](https://github.com/lionix-team)