lionix/envclient

Laravel environment client and console commands.

1.1.3 2021-01-21 07:39 UTC

Requires

• php: ^7.2.5|^8.0
• laravel/framework: >=6.20.12

Requires (Dev)

• orchestra/testbench: ^4.8
• phpunit/phpunit: ^9.3.3

MIT

• Lionix Team
• Anastas Vartanyan

• validation
• laravel
• environment
• env
• dotenv
• lionix

README

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

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

return [

    /**
     * Validation classes which contain environment rules
     * applied by env artisan commands.
     *
     * Add your validation classes created by
     * `php artisan make:envrule` command to apply their rules
     *
     * @var array
     */
    'rules' => [
        \App\Env\BaseEnvValidationRules::class
    ]
];

and app/Env/BaseEnvValidationRules.php

<?php

namespace App\Env;

use Lionix\EnvValidator;

class BaseEnvValidationRules extends EnvValidator
{
    /**
     * Validation rules that apply to the .env variables.
     *
     * @return array
     */
    public function rules() : array
    {
        return [
            //
        ];
    }
}

By adding validation rules into rules method return value you will apply them to env:set command.

...
public function rules() : array
{
    return [
        'DB_CONNECTION' => '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

namespace App\Env;

use Lionix\EnvValidator;

class DatabaseEnvRules extends EnvValidator
{
    /**
     * Validation rules that apply to the .env variables.
     *
     * @return array
     */
    public function rules() : array
    {
        return [
            //
        ];
    }
}

Specify validation rules:

...
public function rules() : array
{
    return [
        'DB_CONNECTION' => '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

return [

    /**
     * Validation classes which contain environment rules
     * applied by env artisan commands.
     *
     * Add your validation classes created by
     * `php artisan make:envrule` command to apply their rules
     *
     * @var array
     */
    'rules' => [
        \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:

...
$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
• Lionix Team