PHPackages ghostwriter/environment - 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. ghostwriter/environment ActiveLibrary[Utility & Helpers](/categories/utility) ghostwriter/environment ======================= Provides Environment Variables derived from `$\_ENV` and `$\_SERVER` super-globals 2.0.0(3y ago)0322.3kBSD-3-ClausePHPPHP >=8.1 <8.3CI passing Since Jul 8Pushed 3w ago1 watchersCompare [ Source](https://github.com/ghostwriter/environment)[ Packagist](https://packagist.org/packages/ghostwriter/environment)[ Docs](https://github.com/ghostwriter/environment)[ GitHub Sponsors](https://github.com/sponsors/ghostwriter)[ RSS](/packages/ghostwriter-environment/feed)WikiDiscussions 2.0.x Synced 3w ago READMEChangelog (8)Dependencies (1)Versions (29)Used By (0) Environment =========== [](#environment) [![Automation](https://github.com/ghostwriter/environment/actions/workflows/automation.yml/badge.svg)](https://github.com/ghostwriter/environment/actions/workflows/automation.yml)[![PHP Version](https://camo.githubusercontent.com/0aec8c5acefb3c60f074900137e2bf358f90431254a113c0054cb5fca8790167/68747470733a2f2f62616467656e2e6e65742f7061636b61676973742f7068702f67686f73747772697465722f656e7669726f6e6d656e743f636f6c6f723d373737424234)](https://www.php.net/supported-versions)[![Packagist Downloads](https://camo.githubusercontent.com/93b57110d48e2226468a14041a65b4c3afc12b87c3e832f27a71f9af71be092e/68747470733a2f2f62616467656e2e6e65742f7061636b61676973742f64742f67686f73747772697465722f656e7669726f6e6d656e743f636f6c6f723d463238443141)](https://packagist.org/packages/ghostwriter/environment)[![PayPal](https://camo.githubusercontent.com/1efa90a77ba349664622c6961afafb52d3aaa44e609dfe3f3e262c7634f29efd/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f70617970616c2d40636f6465706f65742d3030373943313f6c6f676f3d64617461253341696d616765253246737667253242786d6c25334262617365363425324350484e325a79423261575633516d393450534977494441674d6a51674d6a5169494868746247357a50534a6f644852774f693876643364334c6e637a4c6d39795a7938794d4441774c334e325a794925324250484268644767675a443069545445354c6a63784e5341324c6a457a4d324d754d6a51354c5445754f445932494441744d7934784d5330754f546b354c5451754d6a5932517a45334c6a597a4e4334324d6a49674d5455754e7a4978494441674d544d754d7a4133494442494e6934794d7a566a4c5334304d5467674d4330754f5445324c6a51304e433078494334344f446c4d4d69347a4d6a4d674d6a41754e6a4979597a41674c6a4d314e6934794e5334344c6a59324e533434614451754d7a4934624330754d6a55674d5334354e545a6a4c5334774f4451754d7a55314c6a45324e6934324d6a49754e446b344c6a59794d6d677a4c6a59324d324d754e444533494441674c6a677a4d6930754d6a59334c6a6b784e5330754e7a4578646930754d6a5933624334334e446b744e4334324d6a4a324c5334784e7a686a4c6a41344d7930754e4451304c6a55744c6a67754f5445314c53343461433431597a4d754e546334494441674e69347a4d6a55744d5334314d5341334c6a45314e6930314c6a6b314e5334304d5467744d5334344e6a63754d6a55794c544d754d7a63344c5334334e4463744e4334304e4455744c6a49314c53347a4e5455744c6a59324e6930754e6a49794c5445744c6a67344f5349675a6d6c7362443069497a41774f574e6b5a534976506a78775958526f49475139496b30784f5334334d5455674e6934784d7a4e6a4c6a49304f5330784c6a67324e6941774c544d754d5445744c6a6b354f5330304c6a49324e6b4d784e7934324d7a51754e6a4979494445314c6a63794d5341774944457a4c6a4d774e794177534459754d6a4d31597930754e444534494441744c6a6b784e6934304e4451744d5341754f446735544449754d7a497a494449774c6a59794d6d4d774943347a4e5459754d6a55754f4334324e6a55754f4767304c6a4d794f4777784c6a45324e4330334c6a4d334f4330754d44677a4c6a49324e324d754d4467304c5334314d7a4d754e5330754f4467354c6a6b354f4330754f446735614449754d44686a4e4334774e7a6b674d4341334c6a49304d5330784c6a63334f4341344c6a49304c5459754e7a55314c5334774f444d744c6a49324e7941774c53347a4e5459674d4330754e544d304969426d615778735053496a4d4445794d54593549693825324250484268644767675a44306954546b754e54597a494459754d544d7a597934774f4449744c6a49324e6934794e5330754e544d7a4c6a51354f4330754e7a45754d545932494441674c6a49314c5334774f5334304d5459744c6a4135614455754e446b30597934324e6a59674d4341784c6a4d7a4c6a4135494445754f444d754d5463344c6a45324e6941774943347a4d7a4d674d4341754e446b344c6a41344f5334784e6a67754d4467354c6a4d7a4e4334774f446b754e4445344c6a45334f4767754d6a566a4c6a49304f4334774f446b754e446b334c6a49324e6934334e4467754d7a55314c6a49304f4330784c6a67324e6941774c544d754d5445744c6a6b354f5330304c6a4d314e554d784e7934334d5463754e544d7a494445314c6a67774e4341774944457a4c6a4d35494442494e6934794d7a566a4c5334304d5467674d4330754f5445324c6a4d314e693078494334344f446c4d4d69347a4d6a4d674d6a41754e6a4979597a41674c6a4d314e6934794e5334344c6a59324e533434614451754d7a4934624445754d5459304c5463754d7a6334494445754d4467304c5463754f5446364969426d615778735053496a4d44417a4d4467334969382532425043397a646d63253242)](https://paypal.me/codepoet)[![Sponsors via GitHub](https://camo.githubusercontent.com/e97230423d35c583f0bc49b6c18cd7f8ee1fc62c834974e0ee2ef28d1fb2593e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73706f6e736f72732f67686f73747772697465723f6c6162656c3d53706f6e736f722b4067686f73747772697465722f656e7669726f6e6d656e74266c6f676f3d4769744875622b53706f6e736f7273)](https://github.com/sponsors/ghostwriter) Provides Environment Variables derived from `$_ENV` and `$_SERVER` super-globals Installation ------------ [](#installation) You can install the package via composer: ``` composer require ghostwriter/environment ``` Usage ----- [](#usage) ``` $environment = new \Ghostwriter\Environment\Environment(); $environment->has('APP_ENV'); // false $environment->get('APP_ENV', 'dev'); // dev $environment->get('APP_ENV'); // throws NotFoundException $environment->set('APP_ENV', 'production'); $environment->has('APP_ENV'); // true $environment->get('APP_ENV'); // production $environment->unset('APP_ENV'); $environment->set('APP_KEY', 'secrete'); $environment->has('APP_KEY'); // true $environment->get('APP_KEY'); // secrete $environment->unset('APP_KEY'); $environment->has('APP_KEY'); // false $environment->get('APP_KEY', 'fallback-value'); // fallback-value $environment->get('APP_KEY'); // throws NotFoundException ``` API --- [](#api) ``` interface Variables extends Countable, IteratorAggregate { public function count(): int; public function get(string $name, string|null $default = null): string; /** * @return Generator */ public function getIterator(): Generator; public function has(string $name): bool; public function set(string $name, string $value): void; /** * @return non-empty-array */ public function toArray(): array; public function unset(string $name): void; } ``` Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG.md](./CHANGELOG.md) for more information what has changed recently. Security -------- [](#security) If you discover any security related issues, please email `nathanael.esayeas@protonmail.com` instead of using the issue tracker. Sponsors -------- [](#sponsors) \[[`Become a GitHub Sponsor`](https://github.com/sponsors/ghostwriter)\] Credits ------- [](#credits) - [Nathanael Esayeas](https://github.com/ghostwriter) - [All Contributors](https://github.com/ghostwriter/environment/contributors) License ------- [](#license) The BSD-3-Clause. Please see [License File](./LICENSE) for more information. ### Health Score 46 — FairBetter than 92% of packages Maintenance62 Regular maintenance activity Popularity25 Limited adoption so far Community7 Small or concentrated contributor base Maturity74 Established project with proven stability Bus Factor1 Top contributor holds 100% 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 ~89 days Recently: every ~309 days Total 17 Last Release 27d ago Major Versions 0.4.x-dev → 1.0.02022-12-02 1.1.x-dev → 2.0.02023-05-08 2.1.x-dev → 3.0.x-dev2026-06-05 PHP version history (5 changes)0.1.0PHP >=8.0,<8.2 1.0.0PHP >=8.0,<8.3 1.1.0PHP >=8.1,<8.3 2.0.0PHP >=8.1 <8.3 2.0.x-devPHP ~8.4.0 || ~8.5.0 || ~8.6.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/1dbb0131801cc451dad9917ab29aa823b25d7eebc9f3875a9d481d109bdb44ee?d=identicon)[ghostwriter](/maintainers/ghostwriter) --- Top Contributors [![ghostwriter](https://avatars.githubusercontent.com/u/9754361?v=4)](https://github.com/ghostwriter "ghostwriter (1519 commits)") --- Tags environmentenvironment-variablesghostwriterphpserver-variablesenvironmentghostwriterenvironment variablesserver-variables ### Embed Badge ![Health badge](/badges/ghostwriter-environment/health.svg) ``` [![Health](https://phpackages.com/badges/ghostwriter-environment/health.svg)](https://phpackages.com/packages/ghostwriter-environment) ``` ### Alternatives [vlucas/phpdotenv Loads environment variables from `.env` to `getenv()`, `$\_ENV` and `$\_SERVER` automagically. 13.5k640.2M6.3k](/packages/vlucas-phpdotenv)[symfony/dotenv Registers environment variables from a .env file 3.8k243.3M2.8k](/packages/symfony-dotenv)[foroco/php-browser-detection Ultra fast PHP library to detect browser, OS, platform and device type by User-Agent parsing 1545.5M7](/packages/foroco-php-browser-detection)[wolfcast/browser-detection The Wolfcast BrowserDetection PHP class facilitates the identification of the user's environment such as Web browser, version, platform family, platform version or if it's a mobile device or not. 1411.1M7](/packages/wolfcast-browser-detection)[dotenv-org/phpdotenv-vault Load environment variables from encrypted .env.vault files 1019.5k2](/packages/dotenv-org-phpdotenv-vault)[mirazmac/dotenvwriter A PHP library to write values to .env (DotEnv) files 21154.0k12](/packages/mirazmac-dotenvwriter) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)