Download the PHP package linkorb/envoi without Composer
On this page you can find all versions of the php package linkorb/envoi. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download linkorb/envoi
More information about linkorb/envoi
Files in linkorb/envoi
Informations about the package envoi
envoi
Envoi aims to ease the use and documentation of environment variables (env vars) in PHP applications.
Envoi features:
-
a Yaml schema to describe the env vars that may be used to configure an application
-
tools to validate env vars against a schema
-
a tool to assist in the population of a
.env
file - a tool which converts a schema to markdown
Envoi sports a console command which validates a .env
file against a schema
(by convention, .env.yaml
). It also provides checkers that, when invoked
early in the start-up phase of an application, will halt an application which
doesn't have a complete and valid set of env vars.
Install
Use
Env Checkers
A checker should be invoked as early as possible in the life-cycle of an
application. The ideal time is immediately after the environment has been
populated with env vars. For example, in a Symfony-based app, the checker
should be invoked right after the Dotenv component has loaded the env vars from
the various .env*
files:
The checker will throw an exception to halt the application when invalid env vars are found. The list of validation errors is included in the exception message.
EnvChecker
treats the environment as immutable: it validates env vars, but
does not modify them. MutableEnvChecker
validates env vars and can also
transform values, making it the ideal checker when you want to take advantage
of the various env var transformation features of Envoi.
Interpolation
Assign one variable based on another in .env
file
Metadata environment example .env.yaml
Supports types: int
, string
, url
, path
Init environment variables from .env
CLI
Available commands:
validate
Validate based on meta file .env.yaml
.
configure
CLI wizard to ask + update .env file based on .env.yaml
.
markdown
Output a GitHub Flavored Markdown documentation for the available variables.
Look for a <!-- envoi start -->
and <!-- envoi end -->
tags in file (default to README.md), and insert/update the generated markdown between those tags.
Run tests
Contributing
We welcome contributions to make this repository even better. Whether it's fixing a bug, adding a feature, or improving documentation, your help is highly appreciated. To get started, fork this repository then clone your fork.
Be sure to familiarize yourself with LinkORB's code of conduct before submitting any changes.
If you are unable to implement changes you like yourself, don't hesitate to open a new issue report so that we or others may take care of it.
Brought to you by the LinkORB Engineering team
Check out our other projects at linkorb.com/engineering.
By the way, we're hiring!
All versions of envoi with dependencies
symfony/dotenv Version ^3.0|^4.0|^5.0|^6.0
symfony/yaml Version ^3.0|^4.0|^5.0|^6.0
symfony/console Version ^3.0|^4.0|^5.0|^6.0