PHPackages daguilarm/env-manager - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. daguilarm/env-manager ActiveLibrary[Utility & Helpers](/categories/utility) daguilarm/env-manager ===================== A Laravel package to manage .env files with backup functionality. 00PHP Since Jun 21Pushed 10mo ago1 watchersCompare [ Source](https://github.com/daguilarm/env-manager)[ Packagist](https://packagist.org/packages/daguilarm/env-manager)[ RSS](/packages/daguilarm-env-manager/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependenciesVersions (2)Used By (0) Laravel .env Manager ==================== [](#laravel-env-manager) [![Latest Version on Packagist](https://camo.githubusercontent.com/87a977cbd55ce94edea3fedd64563ef7fc6019b9eea631170f8c32c56267321e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f64616775696c61726d2f656e762d6d616e616765722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/daguilarm/env-manager)[![Total Downloads](https://camo.githubusercontent.com/ec2e15bb34425a73790131521da176ed62ea3fa2bc9d53767ee97b6fd5e51fed/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f64616775696c61726d2f656e762d6d616e616765722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/daguilarm/env-manager)[![License](https://camo.githubusercontent.com/1e0efd84f2b1d325cd91e80bd26e4bfa4243366e09f29f109ab13d201acfbdc5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f64616775696c61726d2f656e762d6d616e616765722e7376673f7374796c653d666c61742d737175617265)](LICENSE) A simple and versatil package to programmatically manage your Laravel `.env` files. It allows you to read, write, and update environment variables with ease, including support for comments and automatic backups. Warning **Warning:** This package is currently in a **beta stage**. The `main` branch contains the latest beta version. While it aims to be stable, please use it with caution in production environments and ensure you have backups. We appreciate any feedback or bug reports during this phase. Caution And please note, this package is part of a professional project that needed this feature, and I decided to release it as a Laravel package (in case anyone could benefit from it or find it useful). I've tried to run every possible test to ensure it works. But beyond my own use, I haven't tested it. Despite everything, I'm convinced that all the features work correctly and have their respective tests. Important If you find a bug, a feature that doesn't work correctly, or have a suggestion, don't hesitate to contact me. I'll try to fix or implement it as soon as I have time. Thanks! Features -------- [](#features) - **Read and Parse**: - Accurately reads and parses existing `.env` files directly (in .env format), understanding their structure. - It also supports Laravel Collections to manage the .env files, if you prefere. - **Get Variables**: - Retrieve the value of any environment variable. - Option to provide a default value if the key is not found. - **Set Variables**: Add new variables or update existing ones. - Support for adding/updating inline comments. - Support for adding/updating block comments above a variable. - **Remove Variables**: - Delete environment variables from the file. - **Check Existence**: - Verify if a specific key exists in the `.env` file. - **Comment Preservation**: - Intelligently preserves existing inline and block comments when modifying variables. - **`export` Prefix Preservation**: - Recognizes and maintains the `export` prefix for variables if present. - **Automatic Backups**: - Creates a backup of the `.env` file before any changes are saved. - Configurable backup path. - Configurable retention policy (number of days to keep backups). - **Automatic pruning** of old backups. - **Fluent API**: - Chain methods for a more expressive way to manage variables (e.g., `Env::set('KEY', 'value')->save()`). - **Facade and Dependency Injection**: - Usable via a convenient `Env` and `EnvCollect` facades or by injecting the `EnvManager` or `EnvCollectManager` class service. - **Configuration**: - Publishable configuration file for backup settings. Important Please note that this project has been developed with **Laravel 12** and **PHP 8.3** in mind, so it may not work properly with older versions. Installation ------------ [](#installation) You can install the package via composer: ``` composer require daguilarm/env-manager:^0.0.1 ``` The package will automatically register its service provider. Optionally, you can publish the configuration file using: ``` php artisan vendor:publish --provider="Daguilarm\EnvManager\EnvManagerServiceProvider" --tag="env-manager-config" ``` This will create a `config/env-manager.php` file in your project where you can customize the backup settings. Configuration ------------- [](#configuration) After publishing the configuration file, you can find it at `config/env-manager.php`. Available options: - `backup.enabled`: (bool) Enable or disable automatic backups. Defaults to true. - `backup.path`: (string) The directory path where backups will be stored. Defaults to `storage_path('app/env-manager/env_backups')`. - `backup.retention_days`: (int) The number of days to retain backups. Backups older than this will be pruned. Set to 0 or null to retain forever. - Defaults to 7. Usage ----- [](#usage) - You can use the Env facade or inject the `Daguilarm\EnvManager\Services\EnvManager` class. - And on the other hand, you can manipulate the .env file from two different approaches: 1. You can use the .env file directly. 2. You can use the .env file as a Laravel Collection. Please, remember this is a **beta version**, use it with the utmost caution. ### 1) Using the .env format (you will directly modify the .env file) [](#1-using-the-env-format-you-will-directly-modify-the-env-file) You can manipulate the .env file in its own format, using the `.env format`: ``` use Daguilarm\EnvManager\Facades\Env; // Get all the data as .env $allTheDataAsEnv = Env::getEnvContent(); ///////// Other operations with the ,env file data: // Get a value $appName = Env::get('APP_NAME'); // Get a value with a default $dbHost = Env::get('DB_HOST', '127.0.0.1'); // Check if a key exists if (Env::has('APP_DEBUG')) { // ... } // Set a value Env::set('NEW_VARIABLE', 'its_value')->save(); // Set a value with an inline comment Env::set('API_KEY', 'your_api_key_here')->commentLine('This is an important API key')->save(); // Set a value with block comments above Env::set('MAIL_HOST', 'smtp.example.com')->commentsAbove([ '# Mail Configuration', '# Ensure these are correct for your provider' ])->save(); // Remove a key Env::remove('OLD_VARIABLE'); // Save changes to the .env file // This will also trigger a backup if enabled Env::save(); // Get the entire .env content as a string $envContent = Env::getEnvContent(); ``` ### Using multipleSet() for Batch Updates (.env format). [](#using-multipleset-for-batch-updates-env-format) For setting multiple variables at once with their respective comments, you can use the multipleSet() method for a fluent API: ``` use Daguilarm\EnvManager\Facades\Env; Env::multipleSet() ->setItem('BATCH_KEY_1', 'value1') ->commentLine('Inline comment for BATCH_KEY_1') ->setItem('BATCH_KEY_2', 'value2') ->commentsAbove(['# Block comment for BATCH_KEY_2']) ->save(); ``` ### Using Dependency Injection (.env format) [](#using-dependency-injection-env-format) ``` use Daguilarm\EnvManager\Services\EnvManager; class YourService { protected EnvManager $envManager; public function __construct(EnvManager $envManager) { $this->envManager = $envManager; } public function updateEnv() { $this->envManager ->set('MY_SETTING', 'new_value') ->commentLine('Updated via DI') ->save(); $currentAppName = $this->envManager->get('APP_NAME'); // Do something with $currentAppName } } ``` ### 2) Using Laravel Collection Format [](#2-using-laravel-collection-format) ``` $manager = app(EnvCollectionManager::class); // Get all the collection $envCollection = $manager->getEnvContent(); // Set an existing value $manager->set('APP_DEBUG', 'false') ->commentLine('Production mode'); // Add new value (if the field does not exist) $manager->set('NEW_KEY', 'value') ->commentsAbove('This is a new setting'); // Remove a value by key $manager->remove('OLD_KEY'); // Update the file from a collection $newCollection = collect([...]); $manager->updateFileFromCollection($newCollection); // Save the changes $manager->save(); // Using fluent interface $manager->set('APP_NAME', 'Laravel') ->comment(false) ->commentsAbove('Application Name') ->commentLine('Do not change') ->save(); // And of course, you can use the Facade (EnvCollect) EnvCollect::get('APP_NAME') ->comment(false) ->commentLine('Do not change') ->save(); ``` Backup Management ----------------- [](#backup-management) Backups are created automatically when Env::save() or EnvManager::save() is called, provided backups are enabled in the configuration. Old backups are pruned according to the `retention_days` setting. Testing ------- [](#testing) ``` composer test ``` Contributing ------------ [](#contributing) Contributions are welcome! Please feel free to submit a pull request or create an issue for any bugs or feature requests. - Fork the Project. - Create your Feature Branch (`git checkout -b feature`). - Commit your Changes (`git commit -m 'Add some AmazingFeature'`). - Push to the Branch (`git push origin feature`/AmazingFeature`). - Open a Pull Request. License ------- [](#license) The Laravel **`ENV Manager`** is open-sourced software licensed under the MIT license. ### Health Score 15 — LowBetter than 3% of packages Maintenance38 Infrequent updates — may be unmaintained Popularity0 Limited adoption so far Community7 Small or concentrated contributor base Maturity16 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/5bceb519ebeb489745b1732e1369455d6dc7ee6fe4eca00c3821b3f27e277780?d=identicon)[daguilarm](/maintainers/daguilarm) --- Top Contributors [![daguilarm](https://avatars.githubusercontent.com/u/2663941?v=4)](https://github.com/daguilarm "daguilarm (62 commits)") ### Embed Badge ![Health badge](/badges/daguilarm-env-manager/health.svg) ``` [![Health](https://phpackages.com/badges/daguilarm-env-manager/health.svg)](https://phpackages.com/packages/daguilarm-env-manager) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)