Updated Rector to commit 4a6cb199966a4c12d7178921f4ce36df607e9d17

rectorphp/rector-src@4a6cb19 [Caching] Add CacheMetaExtensionInterface for custom cache invalidation (#7933)

Author: TomasVotruba

src/Application/VersionResolver.php

@@ -19,12 +19,12 @@ final class VersionResolver
      * @api
      * @var string
      */
-    public const PACKAGE_VERSION = 'f7b87f33d7f109a18f8d6a2ce7080e9fb10ba92d';
+    public const PACKAGE_VERSION = '4a6cb199966a4c12d7178921f4ce36df607e9d17';
     /**
      * @api
      * @var string
      */
-    public const RELEASE_DATE = '2026-03-27 11:19:24';
+    public const RELEASE_DATE = '2026-03-27 12:04:27';
     /**
      * @var int
      */

src/Caching/Config/FileHashComputer.php

@@ -4,18 +4,40 @@
 namespace Rector\Caching\Config;
 
 use Rector\Application\VersionResolver;
+use Rector\Caching\Contract\CacheMetaExtensionInterface;
 use Rector\Configuration\Parameter\SimpleParameterProvider;
 use Rector\Exception\ShouldNotHappenException;
 /**
  * Inspired by https://github.com/symplify/easy-coding-standard/blob/e598ab54686e416788f28fcfe007fd08e0f371d9/packages/changed-files-detector/src/FileHashComputer.php
  */
 final class FileHashComputer
 {
+    /**
+     * @var CacheMetaExtensionInterface[]
+     * @readonly
+     */
+    private array $cacheMetaExtensions = [];
+    /**
+     * @param CacheMetaExtensionInterface[] $cacheMetaExtensions
+     */
+    public function __construct(array $cacheMetaExtensions = [])
+    {
+        $this->cacheMetaExtensions = $cacheMetaExtensions;
+    }
     public function compute(string $filePath): string
     {
         $this->ensureIsPhp($filePath);
         $parametersHash = SimpleParameterProvider::hash();
-        return sha1($filePath . $parametersHash . VersionResolver::PACKAGE_VERSION);
+        $extensionHash = $this->computeExtensionHash();
+        return sha1($filePath . $parametersHash . $extensionHash . VersionResolver::PACKAGE_VERSION);
+    }
+    private function computeExtensionHash(): string
+    {
+        $extensionHash = '';
+        foreach ($this->cacheMetaExtensions as $cacheMetaExtension) {
+            $extensionHash .= $cacheMetaExtension->getKey() . ':' . $cacheMetaExtension->getHash();
+        }
+        return $extensionHash;
     }
     private function ensureIsPhp(string $filePath): void
     {

src/Caching/Contract/CacheMetaExtensionInterface.php

@@ -0,0 +1,24 @@
+<?php
+
+declare (strict_types=1);
+namespace Rector\Caching\Contract;
+
+/**
+ * Allows extensions to provide additional metadata for cache invalidation.
+ * When any extension's hash changes, all cached files are reprocessed.
+ *
+ * @api
+ */
+interface CacheMetaExtensionInterface
+{
+    /**
+     * Returns unique key for this cache meta entry.
+     * This describes the source of the metadata.
+     */
+    public function getKey(): string;
+    /**
+     * Returns hash of the cache meta entry.
+     * This represents the current state of the additional meta source.
+     */
+    public function getHash(): string;
+}

src/Config/RectorConfig.php

@@ -5,6 +5,7 @@
 
 use RectorPrefix202603\Illuminate\Container\Container;
 use Override;
+use Rector\Caching\Contract\CacheMetaExtensionInterface;
 use Rector\Caching\Contract\ValueObject\Storage\CacheStorageInterface;
 use Rector\Configuration\Option;
 use Rector\Configuration\Parameter\SimpleParameterProvider;
@@ -284,6 +285,15 @@ public function cacheClass(string $cacheClass): void
         Assert::isAOf($cacheClass, CacheStorageInterface::class);
         SimpleParameterProvider::setParameter(Option::CACHE_CLASS, $cacheClass);
     }
+    /**
+     * @param class-string<CacheMetaExtensionInterface> $cacheMetaExtensionClass
+     */
+    public function cacheMetaExtension(string $cacheMetaExtensionClass): void
+    {
+        Assert::isAOf($cacheMetaExtensionClass, CacheMetaExtensionInterface::class);
+        $this->singleton($cacheMetaExtensionClass);
+        $this->tag($cacheMetaExtensionClass, CacheMetaExtensionInterface::class);
+    }
     /**
      * @see https://github.com/nikic/PHP-Parser/issues/723#issuecomment-712401963
      */

src/Configuration/RectorConfigBuilder.php

@@ -6,6 +6,7 @@
 use PhpParser\NodeVisitor;
 use Rector\Bridge\SetProviderCollector;
 use Rector\Bridge\SetRectorsResolver;
+use Rector\Caching\Contract\CacheMetaExtensionInterface;
 use Rector\Caching\Contract\ValueObject\Storage\CacheStorageInterface;
 use Rector\Composer\InstalledPackageResolver;
 use Rector\Config\Level\CodeQualityLevel;
@@ -82,6 +83,10 @@ final class RectorConfigBuilder
     private ?string $cacheClass = null;
     private ?string $cacheDirectory = null;
     private ?string $containerCacheDirectory = null;
+    /**
+     * @var array<class-string<CacheMetaExtensionInterface>>
+     */
+    private array $cacheMetaExtensions = [];
     private ?bool $parallel = null;
     private int $parallelTimeoutSeconds = 120;
     private int $parallelMaxNumberOfProcess = Defaults::PARALLEL_MAX_NUMBER_OF_PROCESS;
@@ -222,6 +227,9 @@ public function __invoke(RectorConfig $rectorConfig): void
         if ($this->containerCacheDirectory !== null) {
             $rectorConfig->containerCacheDirectory($this->containerCacheDirectory);
         }
+        foreach ($this->cacheMetaExtensions as $cacheMetaExtensionClass) {
+            $rectorConfig->cacheMetaExtension($cacheMetaExtensionClass);
+        }
         if ($this->importNames || $this->importDocBlockNames) {
             $rectorConfig->importNames($this->importNames, $this->importDocBlockNames);
             $rectorConfig->importShortClasses($this->importShortClasses);
@@ -605,6 +613,14 @@ public function withCache(?string $cacheDirectory = null, ?string $cacheClass =
         $this->containerCacheDirectory = $containerCacheDirectory;
         return $this;
     }
+    /**
+     * @param class-string<CacheMetaExtensionInterface> $cacheMetaExtensionClass
+     */
+    public function withCacheMetaExtension(string $cacheMetaExtensionClass): self
+    {
+        $this->cacheMetaExtensions[] = $cacheMetaExtensionClass;
+        return $this;
+    }
     /**
      * @param class-string<ConfigurableRectorInterface> $rectorClass
      * @param mixed[] $configuration

src/DependencyInjection/LazyContainerFactory.php

@@ -35,6 +35,8 @@
 use Rector\BetterPhpDocParser\PhpDocParser\StaticDoctrineAnnotationParser\PlainValueParser;
 use Rector\Caching\Cache;
 use Rector\Caching\CacheFactory;
+use Rector\Caching\Config\FileHashComputer;
+use Rector\Caching\Contract\CacheMetaExtensionInterface;
 use Rector\ChangesReporting\Contract\Output\OutputFormatterInterface;
 use Rector\ChangesReporting\Output\ConsoleOutputFormatter;
 use Rector\ChangesReporting\Output\GitHubOutputFormatter;
@@ -296,6 +298,7 @@ public function create(): RectorConfig
             $cacheFactory = $container->make(CacheFactory::class);
             return $cacheFactory->create();
         });
+        $rectorConfig->when(FileHashComputer::class)->needs('$cacheMetaExtensions')->giveTagged(CacheMetaExtensionInterface::class);
         // tagged services
         $rectorConfig->when(BetterPhpDocParser::class)->needs('$phpDocNodeDecorators')->giveTagged(PhpDocNodeDecoratorInterface::class);
         $rectorConfig->afterResolving(ArrayTypeMapper::class, static function (ArrayTypeMapper $arrayTypeMapper, Container $container): void {

vendor/composer/autoload_classmap.php

@@ -1137,6 +1137,7 @@
     'Rector\\Caching\\Cache' => $baseDir . '/src/Caching/Cache.php',
     'Rector\\Caching\\CacheFactory' => $baseDir . '/src/Caching/CacheFactory.php',
     'Rector\\Caching\\Config\\FileHashComputer' => $baseDir . '/src/Caching/Config/FileHashComputer.php',
+    'Rector\\Caching\\Contract\\CacheMetaExtensionInterface' => $baseDir . '/src/Caching/Contract/CacheMetaExtensionInterface.php',
     'Rector\\Caching\\Contract\\ValueObject\\Storage\\CacheStorageInterface' => $baseDir . '/src/Caching/Contract/ValueObject/Storage/CacheStorageInterface.php',
     'Rector\\Caching\\Detector\\ChangedFilesDetector' => $baseDir . '/src/Caching/Detector/ChangedFilesDetector.php',
     'Rector\\Caching\\Enum\\CacheKey' => $baseDir . '/src/Caching/Enum/CacheKey.php',

vendor/composer/autoload_static.php

@@ -1397,6 +1397,7 @@ class ComposerStaticInitc9819cb6f85619d8e1cbb4426044dd33
         'Rector\\Caching\\Cache' => __DIR__ . '/../..' . '/src/Caching/Cache.php',
         'Rector\\Caching\\CacheFactory' => __DIR__ . '/../..' . '/src/Caching/CacheFactory.php',
         'Rector\\Caching\\Config\\FileHashComputer' => __DIR__ . '/../..' . '/src/Caching/Config/FileHashComputer.php',
+        'Rector\\Caching\\Contract\\CacheMetaExtensionInterface' => __DIR__ . '/../..' . '/src/Caching/Contract/CacheMetaExtensionInterface.php',
         'Rector\\Caching\\Contract\\ValueObject\\Storage\\CacheStorageInterface' => __DIR__ . '/../..' . '/src/Caching/Contract/ValueObject/Storage/CacheStorageInterface.php',
         'Rector\\Caching\\Detector\\ChangedFilesDetector' => __DIR__ . '/../..' . '/src/Caching/Detector/ChangedFilesDetector.php',
         'Rector\\Caching\\Enum\\CacheKey' => __DIR__ . '/../..' . '/src/Caching/Enum/CacheKey.php',