Make the cap configurable via cache.resolvedLocalTypeAliasesCountMax

Default 2048, 0 disables eviction. Chosen from a cap sweep on a 2,358-file
project (all LRU caps set to the sweep value, error output identical at every
point): memory is U-shaped in the cap — 936.5 MB at 512, 880.5 MB at 2048,
930.5 MB uncapped — because too-small caps recreate evicted object graphs as
duplicates while the old ones are still pinned by sibling caches, and
too-large caps converge to unbounded retention. Elapsed time shows no trend
across the whole range (84-101 s noise band).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NrTvR9j1mW2NNNC8RkuTsF

Author: ondrejmirtes

conf/config.neon

@@ -128,6 +128,7 @@ parameters:
 		nameScopeMapMemoryCacheCountMax: 512
 		phpStormStubsNodesCountMax: 128
 		memberCacheKeysMax: 2048
+		resolvedLocalTypeAliasesCountMax: 2048
 	reportUnmatchedIgnoredErrors: true
 	reportIgnoresWithoutComments: false
 	typeAliases: []

conf/parametersSchema.neon

@@ -151,7 +151,8 @@ parametersSchema:
 		resolvedPhpDocBlockCacheCountMax: int(),
 		nameScopeMapMemoryCacheCountMax: int(),
 		phpStormStubsNodesCountMax: int(),
-		memberCacheKeysMax: int()
+		memberCacheKeysMax: int(),
+		resolvedLocalTypeAliasesCountMax: int()
 	])
 	reportUnmatchedIgnoredErrors: bool()
 	reportIgnoresWithoutComments: bool()

src/Testing/PHPStanTestCase.php

@@ -137,6 +137,7 @@ public static function createTypeAliasResolver(array $globalTypeAliases, Reflect
 			$container->getByType(TypeStringResolver::class),
 			$container->getByType(TypeNodeResolver::class),
 			$reflectionProvider,
+			0,
 		);
 	}
 

src/Type/UsefulTypeAliasResolver.php

@@ -18,8 +18,6 @@
 final class UsefulTypeAliasResolver implements TypeAliasResolver
 {
 
-	private const RESOLVED_LOCAL_TYPE_ALIASES_MAX = 2048;
-
 	/** @var array<string, Type> */
 	private array $resolvedGlobalTypeAliases = [];
 
@@ -41,6 +39,8 @@ public function __construct(
 		private TypeStringResolver $typeStringResolver,
 		private TypeNodeResolver $typeNodeResolver,
 		private ReflectionProvider $reflectionProvider,
+		#[AutowiredParameter(ref: '%cache.resolvedLocalTypeAliasesCountMax%')]
+		private int $resolvedLocalTypeAliasesCountMax,
 	)
 	{
 	}
@@ -128,7 +128,7 @@ private function resolveLocalTypeAlias(string $aliasName, NameScope $nameScope):
 		}
 
 		$this->resolvedLocalTypeAliases[$aliasNameInClassScope] = $resolvedAliasType;
-		if (count($this->resolvedLocalTypeAliases) > self::RESOLVED_LOCAL_TYPE_ALIASES_MAX) {
+		if ($this->resolvedLocalTypeAliasesCountMax !== 0 && count($this->resolvedLocalTypeAliases) > $this->resolvedLocalTypeAliasesCountMax) {
 			// resolved alias types transitively pin ClassReflections and their whole
 			// reflection trees — evict the least recently used
 			unset($this->resolvedLocalTypeAliases[array_key_first($this->resolvedLocalTypeAliases)]);