fix: remove global env() helper from package

Author: KolesnikovKirill

CHANGELOG.md

@@ -4,6 +4,27 @@ All notable changes to this package will be documented in this file.
 
 ## [Unreleased]
 
+## [2.0.1] - 2025-10-05
+
+### Fixed
+
+-   Removed global `env()` helper from the package to keep framework-level responsibility in `codemonster-ru/annabel`.
+-   The package now exposes only the static API through `Codemonster\Env\Env`.
+
+### Docs
+
+-   Updated `README.md` to reflect the removal of the global helper.
+    Examples now use `Env::get()` instead of `env()`.
+
+### Tests
+
+-   Updated all tests to use `Env::get()` instead of the removed global `env()` helper.
+
+### Internal
+
+-   Verified autoload configuration in `composer.json` (removed helper file registration).
+-   No API-breaking changes; patch-level release only.
+
 ## [2.0.0] - 2025-09-28
 
 ### Changed

README.md

@@ -17,7 +17,7 @@ composer require codemonster-ru/env
 
 ## 🚀 Usage
 
-Create a .env file in the root of your project:
+Create a `.env` file in the root of your project:
 
 ```dotenv
 APP_NAME=MyApp
@@ -37,15 +37,17 @@ require __DIR__ . '/vendor/autoload.php';
 
 use Codemonster\Env\Env;
 
+// Load environment variables from .env
 Env::load(__DIR__ . '/.env');
 
-echo env('APP_NAME'); // "MyApp"
-var_dump(env('FEATURE_ENABLED')); // true (bool)
-var_dump(env('FEATURE_DISABLED')); // false (bool)
-var_dump(env('OPTIONAL_VALUE')); // null
-var_dump(env('EMPTY_VALUE')); // ""
-echo env('SSR_URL'); // http://localhost:3000
-echo env('NOT_DEFINED', 'default'); // "default"
+// Access values via Env::get()
+echo Env::get('APP_NAME'); // "MyApp"
+var_dump(Env::get('FEATURE_ENABLED')); // true (bool)
+var_dump(Env::get('FEATURE_DISABLED')); // false (bool)
+var_dump(Env::get('OPTIONAL_VALUE')); // null
+var_dump(Env::get('EMPTY_VALUE')); // ""
+echo Env::get('SSR_URL'); // http://localhost:3000
+echo Env::get('NOT_DEFINED', 'default'); // "default"
 ```
 
 ## ✨ Features

composer.json

@@ -4,6 +4,7 @@
     "type": "library",
     "license": "MIT",
     "homepage": "https://github.com/codemonster-ru/env",
+    "readme": "README.md",
     "authors": [
         {
             "name": "Kirill Kolesnikov",
@@ -15,10 +16,7 @@
     "autoload": {
         "psr-4": {
             "Codemonster\\Env\\": "src/"
-        },
-        "files": [
-            "src/helpers.php"
-        ]
+        }
     },
     "require": {
         "php": ">=8.2"

src/Env.php

@@ -28,6 +28,7 @@ public static function load(string $path): void
             if (!array_key_exists($name, $_ENV) && !array_key_exists($name, $_SERVER)) {
                 $_ENV[$name] = $value;
                 $_SERVER[$name] = $value;
+
                 putenv("$name=$value");
             }
         }

src/helpers.php

@@ -26,39 +26,39 @@ protected function setUp(): void
 
     public function testEnvLoadsString(): void
     {
-        $this->assertSame('MyApp', env('APP_NAME'));
+        $this->assertSame('MyApp', Env::get('APP_NAME'));
     }
 
     public function testEnvCastsTrueFalse(): void
     {
-        $this->assertTrue(env('FEATURE_ENABLED'));
-        $this->assertFalse(env('FEATURE_DISABLED'));
+        $this->assertTrue(Env::get('FEATURE_ENABLED'));
+        $this->assertFalse(Env::get('FEATURE_DISABLED'));
     }
 
     public function testEnvCastsNull(): void
     {
-        $this->assertNull(env('OPTIONAL_VALUE'));
+        $this->assertNull(Env::get('OPTIONAL_VALUE'));
     }
 
     public function testEnvCastsEmpty(): void
     {
-        $this->assertSame('', env('EMPTY_VALUE'));
+        $this->assertSame('', Env::get('EMPTY_VALUE'));
     }
 
     public function testEnvRemovesQuotes(): void
     {
-        $this->assertSame('http://localhost:3000', env('SSR_URL'));
+        $this->assertSame('http://localhost:3000', Env::get('SSR_URL'));
     }
 
     public function testEnvHandlesSingleAndDoubleQuotes(): void
     {
-        $this->assertSame('Hello Single', env('QUOTED_SINGLE'));
-        $this->assertSame('Hello Double', env('QUOTED_DOUBLE'));
+        $this->assertSame('Hello Single', Env::get('QUOTED_SINGLE'));
+        $this->assertSame('Hello Double', Env::get('QUOTED_DOUBLE'));
     }
 
     public function testEnvReturnsDefaultIfNotSet(): void
     {
-        $this->assertSame('default', env('NOT_DEFINED', 'default'));
+        $this->assertSame('default', Env::get('NOT_DEFINED', 'default'));
     }
 
     public function testEnvDoesNotOverrideExisting(): void
@@ -67,6 +67,6 @@ public function testEnvDoesNotOverrideExisting(): void
 
         Env::load(__DIR__ . '/.env.example');
 
-        $this->assertSame('ManualApp', env('APP_NAME'));
+        $this->assertSame('ManualApp', Env::get('APP_NAME'));
     }
 }