initphp/dotenv

DotENV Library/Package

2.0.1 2023-07-30 13:44 UTC

This package is auto-updated.

Last update: 2024-10-30 01:59:23 UTC


README

Loads environment variables from .env or .env.php file.

Latest Stable Version Total Downloads Latest Unstable Version License PHP Version Require

Requirements

  • PHP 5.6 or higher

Installation

composer require initphp/dotenv

Usage

Note : Lines starting with any non-alphanumeric character are counted as comments and are not processed.

Note : Existing definitions in the $_SERVER or $_ENV globals are not processed.

.env File

Note that .env files are externally accessible. To prevent access with .htaccess or better yet keep your .env file in a directory that cannot be accessed externally.

/home/www/.env :

# Comment Line
SITE_URL = http://lvh.me

PAGE_URL = ${SITE_URL}/page

; Comment Line
TRUE_VALE = true

EMPTY_VALUE = empty

FALSE_VALUE = false

NULL_VALUE = null

NUMERIC_VALUE = 13
PI_NUMBER = 3.14

any.php :

require_once "vendor/autoload.php";
use \InitPHP\DotENV\DotENV;

DotENV::create('/home/www/.env');

DotENV::get('TRUE_VALE'); // true
DotENV::get('FALSE_VALUE'); // false
DotENV::get('SITE_URL'); // "http://lvh.me"
DotENV::get('PAGE_URL'); // "http://lvh.me/page"
DotENV::get('EMPTY_VALUE'); // ""
DotENV::get('NULL_VALUE'); // NULL
DotENV::get('NUMERIC_VALUE'); // 13
DotENV::get('PI_NUMBER'); // 3.14

DotENV::get('NOT_FOUND', 'hi'); // "hi"

.env.php

/home/www/.env.php :

<?php 
return [
    'SITE_URL'      => 'http://lvh.me',
    'PAGE_URL'      => '${SITE_URL}/page',
    'TRUE_VALE'     => true,
    'EMPTY_VALUE'   => '',
    'FALSE_VALUE'   => false,
    'NULL_VALUE'    => null,
    'NUMERIC_VALUE' => 13
];

any.php :

require_once "vendor/autoload.php";
use \InitPHP\DotENV\DotENV;

DotENV::create('/home/www/.env.php');


DotENV::get('TRUE_VALE'); // true
DotENV::get('FALSE_VALUE'); // false
DotENV::get('SITE_URL'); // "http://lvh.me"
DotENV::get('EMPTY_VALUE'); // ""
DotENV::get('NULL_VALUE'); // NULL
DotENV::get('NUMERIC_VALUE'); // 13

DotENV::get('NOT_FOUND', 'hi'); // "hi"

DotENV::create()

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

public function create(string $path, bool $debug = true): void;
  • $path : The path to the file to be uploaded. If you define a directory path, Dotenv will try to search for the .env or .env.php file itself.
  • $debug : Defines the exception throwing state. If false no exception is thrown.

Note : If the file is not found, the file is not a .env/.env.php file, or is unreadable, it throws a \Exception variant.

DotENV::get()

Returns an ENV value.

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

Note : The priority order is as follows;

$_ENV -> $_SERVER -> getenv()

DotENV::env()

It's an alias for the Dotenv::get() method.

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

Credits

License

Copyright © 2022 MIT License