chore: complete update

2025-07-17 16:24:20 +02:00
parent 899227b0a4
commit 64a7051137
1300 changed files with 85570 additions and 2756 deletions
--- a/src/Framework/Config/Environment.php
+++ b/src/Framework/Config/Environment.php
@@ -0,0 +1,143 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Config;
+
+use App\Framework\Config\Exceptions\RequiredEnvironmentVariableException;
+
+final readonly class Environment
+{
+    public function __construct(
+        private array $variables = []
+    ){}
+
+    public function get(EnvKey|string $key, mixed $default = null): mixed
+    {
+        $key = $this->keyToString($key);
+        // Priorität: 1. System ENV, 2. Loaded variables, 3. Default
+        return $_ENV[$key] ?? $_SERVER[$key] ?? getenv($key) ?: $this->variables[$key] ?? $default;
+    }
+
+    public function getRequired(EnvKey|string $key): mixed
+    {
+        $key = $this->keyToString($key);
+        $value = $this->get($key);
+        if ($value === null) {
+            throw new RequiredEnvironmentVariableException($key);
+        }
+        return $value;
+    }
+
+    public function getInt(EnvKey|string $key, int $default = 0): int
+    {
+        $key = $this->keyToString($key);
+        return (int) $this->get($key, $default);
+    }
+
+    public function getBool(EnvKey|string $key, bool $default = false): bool
+    {
+        $key = $this->keyToString($key);
+        $value = $this->get($key, $default);
+        if (is_string($value)) {
+            return match (strtolower($value)) {
+                'true', '1', 'yes', 'on' => true,
+                'false', '0', 'no', 'off' => false,
+                default => $default
+            };
+        }
+        return (bool) $value;
+    }
+
+    public function getString(EnvKey|string $key, string $default = ''): string
+    {
+        $key = $this->keyToString($key);
+        return (string) $this->get($key, $default);
+    }
+
+    public function getEnum(EnvKey|string $key, string $enumClass, \BackedEnum $default):object
+    {
+        $key = $this->keyToString($key);
+        return forward_static_call([$enumClass, 'tryFrom'], $this->get($key, $default));
+        #$enumClass::tryFrom($this->get($key, $default));
+    }
+
+    public function has(EnvKey|string $key): bool
+    {
+        $key = $this->keyToString($key);
+        return $this->get($key) !== null;
+    }
+
+    public function all(): array
+    {
+        return array_merge(
+            $_ENV,
+            $_SERVER,
+            $this->variables
+        );
+    }
+
+    /**
+     * Factory method für .env file loading
+     */
+    public static function fromFile(string $envPath): self
+    {
+        $variables = [];
+
+        if (file_exists($envPath) && is_readable($envPath)) {
+            $lines = file($envPath, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
+
+            foreach ($lines as $line) {
+                if (str_starts_with(trim($line), '#') || !str_contains($line, '=')) {
+                    continue;
+                }
+
+                [$name, $value] = explode('=', $line, 2);
+                $name = trim($name);
+                $value = trim($value);
+
+                // Remove quotes
+                if (str_starts_with($value, '"') && str_ends_with($value, '"')) {
+                    $value = substr($value, 1, -1);
+                }
+
+                $variables[$name] = self::castValue($value);
+            }
+        }
+
+        return new self($variables);
+    }
+
+    private static function castValue(string $value): mixed
+    {
+        return match (strtolower($value)) {
+            'true' => true,
+            'false' => false,
+            'null' => null,
+            default => is_numeric($value) ? (str_contains($value, '.') ? (float) $value : (int) $value) : $value
+        };
+    }
+
+    public function keyToString(EnvKey|string $key):string
+    {
+        if(is_string($key)) {
+            return $key;
+        }
+        return $key->value;
+    }
+
+    /**
+     * Für Tests
+     */
+    public function withVariable(string $key, mixed $value): self
+    {
+        $variables = $this->variables;
+        $variables[$key] = $value;
+        return new self($variables);
+    }
+
+    public function withVariables(array $variables): self
+    {
+        return new self(array_merge($this->variables, $variables));
+    }
+}