README

A robust PHP package designed to simplify the management and manipulation of .env files within your projects. Effortlessly read, write, update, and delete environment variables with ease.

Important

If you are looking to load/read environment variables then we highly recommend you vlucas/phpdotenv.

Features 🔥

Effortlessly load and parse .env files
Get, set, and remove environment variables
Support for nesting env vars (e.g. DB_CONNECTION.host)
Ability to update existing vars or add new ones
Optionally keep backups of .env files before writing
Helper methods like only() to get subset of variables
Simple chaining methods for a fluent interface
Handles formatting values like booleans and strings
Preserves spacing and comments when writing back to the file
Compatible with various frameworks and environments, ensuring versatility in usage.
Built for PHP 8+ with strict typing

Requirements

PHP 8.1 or higher

Installation

Install via Composer:

composer require larament/dot-env-editor

Usage

use Larament\DotEnvEditor\DotEnvEditor;

$envPath = __DIR__ . '/.env';

$editor = new DotEnvEditor(
    $envPath,   // the path to the.env file
    true,       // whether to keep a backup of the .env file before writing
);

// or using the static method
$editor = DotEnvEditor::load($envPath, true);

// set backup directory
$editor->setBackupDir(__DIR__ . '/backups');

// Get all variables
var_dump($editor->all());

// Get a specific variable
echo $editor->get('AUTHOR_NAME');

// Set a variable
$editor->set('AUTHOR_NAME', 'Raziul Islam');

// set multiple variables
$editor->set([
    'AUTHOR_URL' => 'https://raziul.dev',
    'AUTHOR_COUNTRY' => 'Bangladesh',
]);

// Remove a variable
$editor->remove('AUTHOR_URL');

// write back to the file
$editor->write();

You can use chaining methods for a fluent interface 😘

DotEnvEditor::load($envPath, true)
    ->setBackupDir(__DIR__ . '/backups')
    ->set([
        'AUTHOR_URL' => 'https://raziul.dev',
        'AUTHOR_COUNTRY' => 'Bangladesh',
    ])
    ->remove('AUTHOR_URL')
    ->write();

Dot-Notation & Flat Nesting Support 💡

When using dot-notation keys, they are automatically flattened and converted to standard uppercase snake_case variables. For example:

DB_CONNECTION.host is converted to DB_CONNECTION_HOST
app.url is converted to APP_URL

$editor->set('DB_CONNECTION.host', '127.0.0.1'); // Writes DB_CONNECTION_HOST=127.0.0.1

Usage with Laravel 🔥

In your AppServiceProvider, register DotEnvEditor as a singleton:

use Larament\DotEnvEditor\DotEnvEditor;

public function register(): void
{
    $this->app->singleton(DotEnvEditor::class, function () {
        return DotEnvEditor::load(base_path('.env'))
            ->setBackupDir(storage_path('env-backups')) // backup directory
            ->setBackupCount(5); // only keep latest 5 backup
    });
}

In your controller, you can inject the DotEnvEditor instance and use it to update environment variables:

public function update(DotEnvEditor $envEditor)
{
    // Perform form/data validation

    // save the changes
    $envEditor
        ->set([
            'AUTHOR_URL' => 'https://raziul.dev',
            'AUTHOR_COUNTRY' => 'Bangladesh',
        ])
        ->write();
}

Do you find this package useful?

If this package has helped to simplify your workflow, consider giving it a ⭐️ on GitHub. Your support encourages further development and improvements! 💖

Support

For support, please open an issue on GitHb or submit a pull request.

License

The MIT License (MIT). Please see License File for more information.

larament / dot-env-editor

Maintainers

Package info

Statistics

Security