Fix: Gracefully handle cache drivers that do not support tagging

config/geoip.php

@@ -128,8 +128,10 @@
     | Cache Tags
     |--------------------------------------------------------------------------
     |
-    | Cache tags are not supported when using the file or database cache
-    | drivers in Laravel. This is done so that only locations can be cleared.
+    | Cache tags allow you to selectively clear only GeoIP cached locations
+    | without affecting other cached data. If the active cache driver does
+    | not support tagging (e.g. file, database), tags are automatically
+    | ignored at runtime. Set to null or an empty array to disable tagging.
     |
     */
 

psalm-baseline.xml

@@ -71,7 +71,6 @@
     <MixedArgument>
       <code><![CDATA[$config]]></code>
       <code><![CDATA[$this->config('cache_expires', 30)]]></code>
-      <code><![CDATA[$this->config('cache_tags')]]></code>
       <code><![CDATA[$this->config('default_location', [])]]></code>
     </MixedArgument>
     <MixedArgumentTypeCoercion>

src/Cache.php

@@ -24,11 +24,9 @@ final class Cache
     /**
      * Create a new cache instance.
      *
-     * @param CacheManager $cache
-     * @param array $tags
-     * @param int $expires
+     * @param list<string> $tags
      */
-    public function __construct(CacheManager $cache, $tags, private readonly int $expires = 30)
+    public function __construct(CacheManager $cache, array $tags, private readonly int $expires = 30)
     {
         $this->cache = ($tags === [] || !$cache->supportsTags()) ? $cache : $cache->tags($tags);
     }

src/Console/Clear.php

@@ -24,7 +24,10 @@ class Clear extends Command
     public function handle(): int
     {
         if ($this->isSupported() === false) {
-            $this->output->error('Default cache system does not support tags');
+            $this->output->error(
+                'Cannot selectively clear GeoIP cache: either cache tags are not configured'
+                .' or the active cache driver does not support tagging.'
+            );
             return self::FAILURE;
         }
 
@@ -40,8 +43,8 @@ public function handle(): int
      */
     protected function isSupported(): bool
     {
-        return (empty(app('geoip')->config('cache_tags')) === false)
-            && (in_array(config('cache.default'), ['file', 'database'], true) === false);
+        return !empty(app('geoip')->config('cache_tags'))
+            && app(\Illuminate\Cache\CacheManager::class)->supportsTags();
     }
 
     /**

src/GeoIP.php

@@ -64,9 +64,14 @@ public function __construct(
         private readonly LoggerInterface $logger,
     ) {
         // Create caching instance
+        /** @var list<string> $cacheTags */
+        $cacheTags = array_values((array) $this->config('cache_tags', []));
+        if ($cacheTags !== [] && !$cache->supportsTags()) {
+            $this->logger->warning('GeoIP: cache tags are configured but the active cache driver does not support tagging. Tags will be ignored.');
+        }
         $this->cache = new Cache(
             $cache,
-            $this->config('cache_tags'),
+            $cacheTags,
             $this->config('cache_expires', 30)
         );
         $this->cache->setPrefix((string) $this->config('cache_prefix'));

tests/CacheTest.php

@@ -32,6 +32,32 @@ public function should_return_valid_location(): void
         $this->assertFalse($uncachedLocation->default);
     }
 
+    #[Test]
+    public function should_fall_back_to_untagged_cache_when_driver_does_not_support_tags(): void
+    {
+        // Switch to file driver which does not support tagging
+        config(['cache.default' => 'file']);
+        $cacheManager = app(CacheManager::class);
+
+        $this->assertFalse($cacheManager->supportsTags(), 'File cache driver should not support tags');
+
+        // Tags are configured, but driver doesn't support them — should not throw
+        $cache = new Cache($cacheManager, ['some-tag'], 30);
+
+        $location = new Location([
+            'ip' => '81.2.69.142',
+            'iso_code' => 'US',
+            'lat' => 41.31,
+            'lon' => -72.92,
+        ]);
+
+        $cache->set($location['ip'], $location);
+        $cachedLocation = $cache->get($location['ip']);
+
+        $this->assertInstanceOf(Location::class, $cachedLocation);
+        $this->assertSame('81.2.69.142', $cachedLocation->ip);
+    }
+
     #[Test]
     public function it_flushes_empty_cache(): void
     {