PHPackages devuri/env - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. devuri/env ActiveLibrary[Utility & Helpers](/categories/utility) devuri/env ========== A simple PHP library for accessing $\_ENV. v0.3.2(2y ago)111.6kMITPHPPHP ^7.3 || ^7.4 || ^8.0CI passing Since Feb 19Pushed 2y ago1 watchersCompare [ Source](https://github.com/devuri/env)[ Packagist](https://packagist.org/packages/devuri/env)[ RSS](/packages/devuri-env/feed)WikiDiscussions master Synced today READMEChangelog (9)Dependencies (6)Versions (13)Used By (0) Env Manager =========== [](#env-manager) The Env Manager is a PHP package designed to provide a secure, flexible, and object-oriented approach to managing environment variables in PHP applications. With built-in support for whitelists and optional value encryption, this package ensures that your application handles environment variables in a secure and efficient manner. Features -------- [](#features) - **Whitelist Management**: Securely specify which environment variables are accessible, preventing unauthorized access to sensitive information. - **Optional Encryption**: Encrypt environment variable values for an added layer of security, using a customizable encryption path. - **Type Conversion**: Automatically convert environment variable values to their appropriate data types, including integers and booleans. - **Flexible Configuration**: Easily set and update the whitelist and encryption path as per your application's requirements. Installation ------------ [](#installation) To install the Env Manager, run the following command in your project directory: ``` composer require devuri/env ``` Usage ----- [](#usage) ### Basic Usage [](#basic-usage) ``` use Urisoft\Env; // Initialize the Env with a whitelist of environment variables $env = new Env([ 'APP_KEY', 'DB_HOST', 'DB_NAME', // Add your environment variables here ]); // Retrieve an environment variable $dbHost = $env->get('DB_HOST'); // Retrieve an environment variable with a default value $debugMode = $env->get('DEBUG_MODE', false); ``` ### With Encryption [](#with-encryption) To use the encryption feature, ensure you have set an encryption path and the `Encryption` class is properly configured. ``` $env = new Env([], '/path/to/encryption/key'); // Retrieve and encrypt an environment variable $encryptedAppKey = $env->get('APP_KEY', 'secret value', true ); ``` ### Updating the Whitelist [](#updating-the-whitelist) You can update the whitelist at any time using the `setWhitelist` method. ``` $env->setWhitelist([ 'NEW_VAR_1', 'NEW_VAR_2', // Add new variables as needed ]); ``` ### Create a Convenient Wrapper [](#create-a-convenient-wrapper) To create a function that acts as a convenient wrapper for instantiating and using your `Env` class, you can define a function in a global scope (or within a specific namespace if you prefer to keep things organized). This function can initialize the `Env` class with predefined settings like the whitelist and encryption path, and then return an instance or a specific value from the `Env` object. Here's an example of how you might implement such a function: ``` use Urisoft\Env; /** * Retrieves a sanitized, and optionally encrypted or modified, environment variable by name. * * @param string $name The name of the environment variable to retrieve. * @param mixed $default Default value to return if the environment variable is not set * @param bool $encrypt Indicate that the value should be encrypted. Defaults to false. * @param bool $strtolower Whether to convert the retrieved value to lowercase. Defaults to false. * * @throws InvalidArgumentException If the requested environment variable name is not in the whitelist * or if encryption is requested but the encryption path is not defined. * * @return mixed The sanitized environment variable value, possibly encrypted or typecast, * or transformed to lowercase if specified. */ function env( $name, $default = null, $encrypt = false, $strtolower = false ) { // Define your whitelist and encryption path here. These could also be fetched from a configuration file or another source. $whitelist = [ // Add your environment variables to the whitelist ]; $encryptionPath = '/path/to/your/encryption/key'; // Create an instance of the Env class with your predefined settings static $env = null; if ($env === null) { $env = new Env($whitelist, $encryptionPath); } // Use the Env instance to get the environment variable value return $env->get($name, $default, $encrypt, $strtolower); } ``` ### Notes: [](#notes) - **Static Variable**: The function uses a static variable to store the `Env` instance. This means that the same `Env` object is reused across all calls to the `env` function within a single request, which is efficient because it avoids the overhead of re-instantiating the `Env` class every time the function is called. - **Configuration**: The whitelist and encryption path are hardcoded in this example, but you might want to load these from a configuration file or environment variables to make the function more flexible and environment-specific. - **Global vs. Namespaced**: Depending on your application's architecture, you might place this function in the global namespace (as shown) or within a specific namespace. If placed within a namespace, remember to reference it correctly when calling the function. - **Reusability**: This approach makes it easy to fetch environment variables using the `env` function throughout your application, leveraging the full functionality of the `Env` class with minimal boilerplate code. This function can then be used throughout your application to fetch environment variables in a standardized way, like so: ``` $dbHost = env('DB_HOST'); $debugMode = env('DEBUG_MODE', false); ``` > Adjust the implementation details such as the whitelist and encryption path to suit your application's needs. Security -------- [](#security) The Env Manager includes a whitelist feature to ensure only predefined environment variables are accessible, adding an extra layer of security to your application. When using the encryption feature, ensure that your encryption keys are stored securely and are not accessible to unauthorized users. Contributing ------------ [](#contributing) Contributions to the Urisoft Env Manager are welcome! Please ensure that your contributions follow the project's coding standards and include tests for new features or bug fixes. License ------- [](#license) Licensed under the MIT License. See the [LICENSE](LICENSE) file for details. ### Health Score 26 — LowBetter than 41% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity21 Limited adoption so far Community9 Small or concentrated contributor base Maturity44 Maturing project, gaining track record Bus Factor1 Top contributor holds 80.8% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~5 days Total 12 Last Release 806d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/8fd19f958b007ec6588d0a5ca2fe78e107edd652f286b836d36b5d1781d573a5?d=identicon)[devuri](/maintainers/devuri) --- Top Contributors [![devuri](https://avatars.githubusercontent.com/u/4777400?v=4)](https://github.com/devuri "devuri (42 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (10 commits)") ### Code Quality TestsPHPUnit Static AnalysisPHPStan, Psalm Type Coverage Yes ### Embed Badge ![Health badge](/badges/devuri-env/health.svg) ``` [![Health](https://phpackages.com/badges/devuri-env/health.svg)](https://phpackages.com/packages/devuri-env) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)