From ccf68c96b0d4b07f62bda999a5f1b5f4f2b08969 Mon Sep 17 00:00:00 2001
From: Snider <snider@host.uk.com>
Date: Mon, 27 Apr 2026 16:06:41 +0100
Subject: [PATCH] fix(psalm): suppress NoEnvOutsideConfig for parity with
 PHPStan baseline
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The Psalm Laravel plugin emits NoEnvOutsideConfig for every env() call
outside config/ — 176 instances in src/Core/config.php alone. PHPStan
already ignores the equivalent identifier
(larastan.noEnvCallsOutsideOfConfig) via phpstan.neon.

Locally Psalm doesn't load the plugin's runtime check (works via the
plugin's bootstrap file at composer install time on Linux runners), so
the failure only surfaces in CI. Suppress at the issue-handler level
matching the existing PHPStan exemption.

Co-Authored-By: Cladius Maximus <claude@anthropic.com>
---
 psalm.xml | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/psalm.xml b/psalm.xml
index ef44739..40a9aea 100644
--- a/psalm.xml
+++ b/psalm.xml
@@ -19,6 +19,15 @@
             </errorLevel>
         </MissingOverrideAttribute>
 
+        <!-- Laravel plugin (Psalm) flags env() calls outside config/. PHPStan
+             ignores the equivalent identifier (larastan.noEnvCallsOutsideOfConfig).
+             Suppress here for parity with PHPStan baseline. -->
+        <NoEnvOutsideConfig>
+            <errorLevel type="suppress">
+                <directory name="src" />
+            </errorLevel>
+        </NoEnvOutsideConfig>
+
         <!-- Suppress optional dependency errors -->
         <UndefinedClass>
             <errorLevel type="suppress">