Installation

Simply install the library using composer:

composer require bgaze/php-dotenv

Usage

Quick start

This package ships two classes :

• Bgaze\Dotenv\Parser which does the parsing job.
• Bgaze\Dotenv\Helpers which provides static functions for a quick usage of the parser.

To quickly parse Dotenv, use helper functions from the Helpers class:

use \Bgaze\Dotenv\Helpers as DotEnv;

try {
    var_dump(DotEnv::fromString('a dotenv string', [ /* some default values */ ]));
} catch (\Exception $e) {
    echo "<pre>{$e}</pre>";
}

try {
    var_dump(DotEnv::fromFile('path/to/dotenv/file', [ /* some default values */ ]));
} catch (\Exception $e) {
    echo "<pre>{$e}</pre>";
}

You can also directly use the Parser class:

use \Bgaze\Dotenv\Parser;

$parser = new Parser();

if ($parser->parseString('a dotenv string')) {
    var_dump($parser->get());
} else {
    var_dump($parser->errors());
}

if ($parser->parseFile('path/to/dotenv/file')) {
    var_dump($parser->get());
} else {
    var_dump($parser->errors());
}

Helpers class

fromString:

Parse the provided string, throw an exception if invalid, otherwise return parsed content as a key-value array.

/**
 * @param string $string The string to parse
 * @param array $defaults An array of default values
 * @return array The parsed content
 *
 * @throws \UnexpectedValueException
 */
public static function fromString($string, array $defaults = []);

fromFile:

Parse the provided file, throw an exception if invalid, otherwise return parsed content as a key-value array.

/**
 * @param string $path The file to parse
 * @param array $defaults An array of default values
 * @return array The parsed content
 *
 * @throws \InvalidArgumentException
 * @throws \UnexpectedValueException
 */
public static function fromFile($path, array $defaults = []);

Parser class

parseString:

Reset parser then parse the provided string.

/**
 * @param string $string The string to parse
 * @return boolean
 */
public function parseString($string);

parseFile:

Reset parser then parse the provided file.

/**
 * @param string $path Path of the file to parse
 * @return boolean
 */
public function parseFile($path);

get:

Get parsed content array.

/**
 * @return array
 */
public function get();

errors:

Get parsing errors array.

/**
 * @return array
 */
public function errors();

Other packages

Feel free to visit my other packages: