Download the PHP package rammewerk/environment without Composer
On this page you can find all versions of the php package rammewerk/environment. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download rammewerk/environment
More information about rammewerk/environment
Files in rammewerk/environment
Package environment
Short Description A simple and fast environment variable handler for PHP projects.
License MIT
Homepage https://rammewerk.com
Informations about the package environment
Rammewerk Environment
A simple and fast environment variable handler for projects.
This package is a different approach to handle environment variables in your project:
- Parses and automatically caches .env file
- Will NOT add variables to $_ENV - as it might lead to exposing values if you are not careful with your debugging.
- No other dependencies - small size.
- Will automatically convert values to types like boolean, integer, null and even array (read more below)
- Support closure to validate environment variables
- Includes caching for even faster loading.
- Support for multiple files
Important: There are some limitations to the .env file format. See below.
Getting Started
Support for multiple .env files
You can add multiple environment files or create new variables on the fly.
A file does not necessarily need to be .env. For instance, a file.txt will also work as long as it is correctly formatted.
Caching
Validating environment variables
Limitations
This is a simple env parser. You will need to format your env-files accordingly:
Variable names
Environment variable names must consist solely of letters, digits, and the underscore ( _ ) and must not begin with a digit.
Comments
Comments are only allowed on new lines, never on the same line as variables.
Variable values
Values can be quoted.
Values will be trimmed and converted to types
Tips
A new Environment()
will return a new instance of the class. So, if you use a dependency injection container or
similar, consider making the Environment class a shared instance. Or make your own singleton wrapper.
Typed getters
You can use typed getters to get the value of a key as a specific type. For example:
If the value is not a string, int, float, bool or array, the getter will return null.