Clemens Schwaighofer
06479cadea
Add Readme file update for install via composer psalm static checker added phan and phpstan update with ignoring vendor and test files as they are not needed in final system
51 lines
1.6 KiB
Markdown
51 lines
1.6 KiB
Markdown
# dotenv: readEnvFile()
|
|
|
|
A simple implementation of <https://github.com/vlucas/phpdotenv>
|
|
|
|
This is not a functional replacement, but a very simple implementation of the basic functions.
|
|
|
|
It is recommended to create a `.env.example` example file that is checked into the
|
|
repository. The `.env` should *NEVER* be checked into anything
|
|
|
|
## How to install
|
|
|
|
`comoser require gullevek/dotEnv`
|
|
|
|
## How it works
|
|
|
|
Put the function where it is needed or put it in a file and load it.
|
|
|
|
if not parameter is given it will use `__DIR__` as base path.
|
|
Second parameter is file name override. Default is `.env`
|
|
|
|
Data is loaded into _ENV only.
|
|
|
|
If there is already an entry in _ENV then it will not be overwritten.
|
|
|
|
## .env file example
|
|
|
|
A valid entry has to start with an alphanumeric string, underscores are allowed and
|
|
then have an equal sign (=). After the equal sign the data block starts. Data can be
|
|
quoted with double quotes (") and if this is done can stretch over multiple lines.
|
|
The openeing double quote must be on the same lign as the requal sign (=). If double
|
|
quoted (") charcters are used it will read each line until another double quote (")
|
|
character is found. Everything after that is ignored.
|
|
|
|
Any spaces before the variable or before and after the equal sign (=) are ignored.
|
|
|
|
Line is read until `PHP_EOL`. So any trailing spaces are read too.
|
|
|
|
Any line that is not valid is ignored.
|
|
|
|
```ini
|
|
# this line is ignored
|
|
SOMETHING=A
|
|
OTHER="A B C"
|
|
MULTI_LINE="1 2 3
|
|
4 5 6
|
|
7 8 9" ; and this is ignored
|
|
ESCAPE="String \" inside \" other "
|
|
DOUBLE="I will be used"
|
|
DOUBLE="This will be ignored"
|
|
```
|