test(support): load local env for optional integration suite

Signed-off-by: Vitor Mattos <vitor@php.rio>

Author: vitormattos

tests/Support/LoadsLocalEnv.php

@@ -0,0 +1,62 @@
+<?php
+
+// SPDX-FileCopyrightText: 2026 LibreCode coop and contributors
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+declare(strict_types=1);
+
+namespace LibreCodeCoop\NfsePHP\Tests\Support;
+
+trait LoadsLocalEnv
+{
+    private static bool $envLoaded = false;
+
+    protected static function loadLocalEnv(): void
+    {
+        if (self::$envLoaded) {
+            return;
+        }
+
+        self::$envLoaded = true;
+
+        $root = dirname(__DIR__, 2);
+
+        self::loadFile($root . '/.env.local');
+        self::loadFile($root . '/.env');
+    }
+
+    private static function loadFile(string $path): void
+    {
+        if (!is_file($path)) {
+            return;
+        }
+
+        $lines = file($path, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
+
+        if ($lines === false) {
+            return;
+        }
+
+        foreach ($lines as $line) {
+            $line = trim($line);
+
+            if ($line === '' || str_starts_with($line, '#') || !str_contains($line, '=')) {
+                continue;
+            }
+
+            [$key, $value] = explode('=', $line, 2);
+
+            $key = trim($key);
+            if ($key === '' || getenv($key) !== false) {
+                continue;
+            }
+
+            $value = trim($value);
+            $value = trim($value, "\"'");
+
+            putenv($key . '=' . $value);
+            $_ENV[$key] = $value;
+            $_SERVER[$key] = $value;
+        }
+    }
+}