test(lock): document unsupported store path for analysis

- Add intersection PHPDoc for LockManager cache-store requirements
- Keep the runtime LockException for unsupported cache handlers
- Add targeted PHPStan ignore for the test that intentionally exercises the exception path"

Signed-off-by: memleakd <121398829+memleakd@users.noreply.github.com>

Author: memleakd

system/Lock/LockManager.php

@@ -26,7 +26,7 @@
     private LockStoreInterface $store;
 
     /**
-     * @param CacheInterface $cache Cache handler that must also implement LockStoreProviderInterface.
+     * @param CacheInterface&LockStoreProviderInterface $cache Cache handler that supports lock stores.
      *
      * @throws LockException When the cache handler does not support locks.
      */

tests/system/Lock/LockTest.php

@@ -194,6 +194,7 @@ public function testUnsupportedCacheHandlerThrows(): void
         $this->expectException(LockException::class);
         $this->expectExceptionMessage('does not support locks');
 
+        // @phpstan-ignore argument.type
         new LockManager(CacheFactory::getHandler($this->config, 'dummy'));
     }