Skip to content

api-reference.md

Latest commit

 

History

History
108 lines (73 loc) · 2.67 KB

api-reference.md

File metadata and controls

108 lines (73 loc) · 2.67 KB

API reference

The package exposes one worker class (Repository), a static facade over a shared instance of it (DotENV), and one global helper (env()).

Repository

InitPHP\DotENV\Repository

create()

public function create(string $path, bool $debug = true): void

Reads and defines a .env or .env.php file.

  • $path — a path to a .env/.env.php file, or to a directory that contains one. When a directory is given, .env is tried first, then .env.php.
  • $debug — when true (default), problems throw a DotENVException; when false, problems are ignored and the method returns without defining anything.

Values already present in $_ENV or $_SERVER are not overwritten.

get()

public function get(string $name, mixed $default = null): mixed

Returns an environment value, looked up as $_ENV → $_SERVER → getenv(). Strings are coerced (value types) and ${VAR} references are interpolated (interpolation). Returns $default when the name is not defined anywhere.

env()

public function env(string $name, mixed $default = null): mixed

Alias of get().

flush()

public function flush(): void

Removes every value this repository defined (from $_ENV, $_SERVER and putenv()) and clears the read cache. Pre-existing environment variables are left untouched.

DotENV (facade)

InitPHP\DotENV\DotENV

A static facade that forwards create(), get(), env() and flush() to a single shared Repository. It adds two lifecycle helpers:

instance()

public static function instance(): Repository

Returns the shared repository, creating it on first use.

reset()

public static function reset(): void

Flushes the shared repository and discards it, so the next call builds a fresh one. Useful in tests and long-running workers.

use InitPHP\DotENV\DotENV;

DotENV::create(__DIR__);
DotENV::get('APP_ENV');
DotENV::flush();   // unload, keep the instance
DotENV::reset();   // unload and drop the instance

env() global helper

Registered through Composer's files autoloader:

function env(string $name, mixed $default = null): mixed

Equivalent to DotENV::get($name, $default) and shares the same shared repository. It is only defined if no other env() function already exists.

$appEnv = env('APP_ENV', 'production');

Backwards compatibility: Lib

Before 3.0 the worker class was named InitPHP\DotENV\Lib. That name still resolves — it is registered as an alias of Repository — but it is deprecated. Use Repository in new code.