Download the PHP package mifesta/dotenv-editor without Composer

Laravel Dotenv Editor

Laravel Dotenv Editor is an the .env file editor (or files with same structure and syntax) for Laravel 5+. Now you can easily edit .env files with following features:

• Read raw content of file
• Read lines in file content
• Read setters (key-value-pair) in file content
• Determine one key name of setter if exists
• Append empty lines into file
• Append comment lines into file
• Append new or update exists setter lines into file
• Delete exists setter line in file
• Backup and restore file
• Manage backup files

Documentation

Look at one of the following topics to learn more about Laravel Dotenv Editor

• Versions and compatibility
• Installation
• Configuration
  • Auto backup mode
  • Backup location
• Usage
  • Working with facade
  • Using dependency injection
  • Loading file for working
  • Reading file content
    • Reading raw content
    • Reading content by lines
    • Reading content by keys
    • Determine if key is exists
    • Get value of a key
  • Writing content into file
    • Add an empty line into buffer
    • Add a comment line into buffer
    • Add or update a setter into buffer
    • Add or update multi setter into buffer
    • Delete a setter line in buffer
    • Delete multi setter lines in buffer
    • Save buffer into file
  • Backing up and restoring file
    • Backup your file
    • Get all backup versions
    • Get latest backup version
    • Restore your file from latest backup or other file
    • Delete one backup file
    • Delete multi backup files
    • Change auto backup mode
  • Method chaining
  • Working with Artisan CLI
• License
• Thanks from author

Versions and compatibility

Currently, Laravel Dotenv Editor only have version 1.x that is compatible with Laravel 5+ and later. This package is not support for Laravel 4.2 and earlier versions.

Installation

You can install this package through Composer.

• First, edit your project's composer.json file to require mifesta/dotenv-editor:

• Next, run the composer update command in your command line interface:

Note: Instead of performing the above two steps, you can perform faster with the command line $ composer require mifesta/dotenv-editor:1.*.

• Once update operation completes, the third step is add the service provider. Open config/app.php, and add a new item to the providers array:

• The next step is add the follow line to the section aliases in file config/app.php:

Configuration

To get started, you'll need to publish configuration file:

This will create a config/dotenv-editor.php file in your app that you can modify to set your configuration. Also, make sure you check for changes to the original config file in this package between releases.

Auto backup mode

The option autoBackup is determine that your orignal file will be backed up before save or not.

Backup location

The option backupPath is where that your file is backed up to. This value is the sub path (sub-folder) from root folder of project application.

Usage

Working with facade

Laravel Dotenv Editor has a facade with name is Mifesta\DotenvEditor\Facades\DotenvEditor. You can do any operation through this facade. For example:

Using dependency injection

This package also supports dependency injection, you can easily use dependency injection to inject an instance of the Mifesta\DotenvEditor\DotenvEditor class into your controller or other class. Example:

Loading file for working

Default, Laravel Dotenv Editor will load file .env in root folder of your project whenever you use the DotenvEditor facade. Example:

However, if you want to explicitly specify what files you will work with, you should use method load(). Example:

$file = DotenvEditor::load(); // Working with file .env in root folder
$file = DotenvEditor::load('.env.example'); // Working with file .env.example in root folder
$file = DotenvEditor::load(storage_path('dotenv-editor/backups/.env.backup')); // Working with file .env.backup in folder storage/dotenv-editor/backups/

Method load() have three parameters:

• The first parameter is the path to file you want to work with. Set null to work with file .env in root folder.
• The second parameter is allow restoring your file if it is not found.
• The third parameter is the path to file use to restoring. Set null to restore from a earlier backup file.

Reading file content

Reading raw content

You can use method getContent() to get raw content in your file. Example:

This will return raw file content as a string

Reading content by lines

Use method getLines() to get all lines in your file. Example:

This will return an array. Each element in array, you can see following info:

• Number of line
• Raw content of line
• Parsed content of line, include: type of line (empty, comment, setter...), key name of setter, value of setter, comment of setter...

Reading content by keys

Use method getKeys($keys = []) to get all setter lines in your file. Example:

This will return an array. Each element in array, you can see following info:

• Number of line
• Key name of setter
• Value of setter
• Comment of setter
• This key used "export " command or not

Determine if key is exists

Use method keyExists($key). Example:

Get value of a key

Use method getValue($key). Example:

Writing content into file

To edit file content, you have two job:

• First is writing content into buffer
• Second is saving buffer into file

Add an empty line into buffer

Use method addEmpty(). Example:

Add a comment line into buffer

Use method addComment($comment). Example:

Add or update a setter into buffer

Use method setKey($key, $value = null, $comment = null, $export = false). Example:

Add or update multi setter into buffer

Use method setKeys($data). Example:

Delete a setter line in buffer

Use method deleteKey($key). Example:

Delete multi setter lines in buffer

Use method deleteKeys($keys). Example:

Save buffer into file

Backing up and restoring file

Backup your file

Get all backup versions

Get latest backup version

Restore your file from latest backup or other file

Delete one backup file

Delete multi backup files

Change auto backup mode

Method chaining

Some functions of loading, writing, backing up, restoring are implementation and usage of method chaining. So these functions can be called to chained together in a single statement. Example:

Working with Artisan CLI

Now, Laravel Dotenv Editor have total 6 commands can use easily with Artisan CLI. Such as:

• php artisan dotenv:backup
• php artisan dotenv:get-backups
• php artisan dotenv:restore
• php artisan dotenv:get-keys
• php artisan dotenv:set-key
• php artisan dotenv:delete-key

Please use each above command with option --help(-h) for details of usage. Example:

Exceptions

License

The Laravel Dotenv Editor is open-source software licensed under the MIT license.

Thanks for use

Hopefully, this package is useful to you.