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.
- 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
- PHP 8.1 or higher
Install via Composer:
composer require digimax/dot-env-editoruse Digimax\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();DotEnvEditor::load($envPath, true)
->setBackupDir(__DIR__ . '/backups')
->set([
'AUTHOR_URL' => 'https://raziul.dev',
'AUTHOR_COUNTRY' => 'Bangladesh',
])
->remove('AUTHOR_URL')
->write();In your AppServiceProvider, register DotEnvEditor as a singleton:
use Digimax\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();
}If this package has helped to simplify your workflow, consider giving it a ⭐️ on GitHub. Your support encourages further development and improvements! 💖
For support, please open an issue on GitHb or submit a pull request.
The MIT License (MIT). Please see License File for more information.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent