feat: configurable stub cache via LARAVEL_PLUGIN_CACHE_PATH

Author: Viacheslav Danilin

src/Providers/CacheDirectoryProvider.php

@@ -4,10 +4,18 @@
 
 namespace Psalm\LaravelPlugin\Providers;
 
+use function getenv;
+use function rtrim;
+
 final class CacheDirectoryProvider
 {
     public static function getCacheLocation(): string
     {
+        $env = getenv('LARAVEL_PLUGIN_CACHE_PATH');
+        if ($env !== false && $env !== '') {
+            return rtrim($env, '/');
+        }
+
         return __DIR__ . '/../../cache';
     }
 }

tests/Unit/Providers/CacheDirectoryProviderTest.php

@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tests\Unit\Providers;
+
+use PHPUnit\Framework\TestCase;
+use Psalm\LaravelPlugin\Providers\CacheDirectoryProvider;
+
+use function putenv;
+use function sys_get_temp_dir;
+
+final class CacheDirectoryProviderTest extends TestCase
+{
+    protected function tearDown(): void
+    {
+        putenv('LARAVEL_PLUGIN_CACHE_PATH');
+    }
+
+    public function testReturnsDefaultPathIfEnvNotSet(): void
+    {
+        $path = CacheDirectoryProvider::getCacheLocation();
+
+        $this->assertStringEndsWith('/cache', $path);
+        $this->assertFileExists($path);
+    }
+
+    public function testReturnsCustomPathFromEnv(): void
+    {
+        $custom = sys_get_temp_dir() . '/psalm-laravel-stubs-test';
+        putenv("LARAVEL_PLUGIN_CACHE_PATH={$custom}");
+
+        $this->assertSame($custom, CacheDirectoryProvider::getCacheLocation());
+    }
+}