Update warmup signature on all WarmableInterface implementations

okhoshi · okhoshi · commit 38fa98585fe1 · 2023-10-16T22:57:24.000+02:00
Signed-off-by: Quentin Devos &lt;4972091+Okhoshi@users.noreply.github.com&gt;
diff --git a/src/Symfony/Bridge/Doctrine/CacheWarmer/ProxyCacheWarmer.php b/src/Symfony/Bridge/Doctrine/CacheWarmer/ProxyCacheWarmer.php
@@ -38,9 +38,9 @@ public function isOptional(): bool
     }
 
     /**
-     * @return string[] A list of files to preload on PHP 7.4+
+     * @param string|null $buildDir
      */
-    public function warmUp(string $cacheDir): array
+    public function warmUp(string $cacheDir /* , string $buildDir = null */): array
     {
         $files = [];
         foreach ($this->registry->getManagers() as $em) {
diff --git a/src/Symfony/Bundle/FrameworkBundle/CacheWarmer/AbstractPhpFileCacheWarmer.php b/src/Symfony/Bundle/FrameworkBundle/CacheWarmer/AbstractPhpFileCacheWarmer.php
@@ -35,15 +35,16 @@ public function isOptional(): bool
     }
 
     /**
-     * @return string[] A list of classes to preload on PHP 7.4+
+     * @param string|null $buildDir
      */
-    public function warmUp(string $cacheDir): array
+    public function warmUp(string $cacheDir /* , string $buildDir = null */): array
     {
+        $buildDir = 1 < \func_num_args() ? func_get_arg(1) : null;
         $arrayAdapter = new ArrayAdapter();
 
         spl_autoload_register([ClassExistenceResource::class, 'throwOnRequiredClass']);
         try {
-            if (!$this->doWarmUp($cacheDir, $arrayAdapter)) {
+            if (!$this->doWarmUp($cacheDir, $arrayAdapter, $buildDir)) {
                 return [];
             }
         } finally {
@@ -78,7 +79,9 @@ final protected function ignoreAutoloadException(string $class, \Exception $exce
     }
 
     /**
+     * @param string|null $buildDir
+     *
      * @return bool false if there is nothing to warm-up
      */
-    abstract protected function doWarmUp(string $cacheDir, ArrayAdapter $arrayAdapter): bool;
+    abstract protected function doWarmUp(string $cacheDir, ArrayAdapter $arrayAdapter /* , string $buildDir = null */): bool;
 }
diff --git a/src/Symfony/Bundle/FrameworkBundle/CacheWarmer/AnnotationsCacheWarmer.php b/src/Symfony/Bundle/FrameworkBundle/CacheWarmer/AnnotationsCacheWarmer.php
@@ -44,7 +44,10 @@ public function __construct(
         parent::__construct($phpArrayFile);
     }
 
-    protected function doWarmUp(string $cacheDir, ArrayAdapter $arrayAdapter): bool
+    /**
+     * @param string|null $buildDir
+     */
+    protected function doWarmUp(string $cacheDir, ArrayAdapter $arrayAdapter /* , string $buildDir = null */): bool
     {
         $annotatedClassPatterns = $cacheDir.'/annotations.map';
 
diff --git a/src/Symfony/Bundle/FrameworkBundle/CacheWarmer/CachePoolClearerCacheWarmer.php b/src/Symfony/Bundle/FrameworkBundle/CacheWarmer/CachePoolClearerCacheWarmer.php
@@ -37,10 +37,7 @@ public function __construct(Psr6CacheClearer $poolClearer, array $pools = [])
         $this->pools = $pools;
     }
 
-    /**
-     * @return string[]
-     */
-    public function warmUp(string $cacheDirectory): array
+    public function warmUp(string $cacheDir, string $buildDir = null): array
     {
         foreach ($this->pools as $pool) {
             if ($this->poolClearer->hasPool($pool)) {
diff --git a/src/Symfony/Bundle/FrameworkBundle/CacheWarmer/RouterCacheWarmer.php b/src/Symfony/Bundle/FrameworkBundle/CacheWarmer/RouterCacheWarmer.php
@@ -34,12 +34,12 @@ public function __construct(ContainerInterface $container)
         $this->container = $container;
     }
 
-    public function warmUp(string $cacheDir): array
+    public function warmUp(string $cacheDir, string $buildDir = null): array
     {
         $router = $this->container->get('router');
 
         if ($router instanceof WarmableInterface) {
-            return (array) $router->warmUp($cacheDir);
+            return (array) $router->warmUp($cacheDir, $buildDir);
         }
 
         throw new \LogicException(sprintf('The router "%s" cannot be warmed up because it does not implement "%s".', get_debug_type($router), WarmableInterface::class));
diff --git a/src/Symfony/Bundle/FrameworkBundle/CacheWarmer/SerializerCacheWarmer.php b/src/Symfony/Bundle/FrameworkBundle/CacheWarmer/SerializerCacheWarmer.php
@@ -39,7 +39,10 @@ public function __construct(array $loaders, string $phpArrayFile)
         $this->loaders = $loaders;
     }
 
-    protected function doWarmUp(string $cacheDir, ArrayAdapter $arrayAdapter): bool
+    /**
+     * @param string|null $buildDir
+     */
+    protected function doWarmUp(string $cacheDir, ArrayAdapter $arrayAdapter /* , string $buildDir = null */): bool
     {
         if (!$this->loaders) {
             return true;
diff --git a/src/Symfony/Bundle/FrameworkBundle/CacheWarmer/TranslationsCacheWarmer.php b/src/Symfony/Bundle/FrameworkBundle/CacheWarmer/TranslationsCacheWarmer.php
@@ -34,14 +34,16 @@ public function __construct(ContainerInterface $container)
     }
 
     /**
-     * @return string[]
+     * @param string|null $buildDir
      */
-    public function warmUp(string $cacheDir): array
+    public function warmUp(string $cacheDir /* , string $buildDir = null */): array
     {
         $this->translator ??= $this->container->get('translator');
 
         if ($this->translator instanceof WarmableInterface) {
-            return (array) $this->translator->warmUp($cacheDir);
+            $buildDir = 1 < \func_num_args() ? func_get_arg(1) : null;
+
+            return (array) $this->translator->warmUp($cacheDir, $buildDir);
         }
 
         return [];
diff --git a/src/Symfony/Bundle/FrameworkBundle/CacheWarmer/ValidatorCacheWarmer.php b/src/Symfony/Bundle/FrameworkBundle/CacheWarmer/ValidatorCacheWarmer.php
@@ -39,7 +39,10 @@ public function __construct(ValidatorBuilder $validatorBuilder, string $phpArray
         $this->validatorBuilder = $validatorBuilder;
     }
 
-    protected function doWarmUp(string $cacheDir, ArrayAdapter $arrayAdapter): bool
+    /**
+     * @param string|null $buildDir
+     */
+    protected function doWarmUp(string $cacheDir, ArrayAdapter $arrayAdapter /* , string $buildDir = null */): bool
     {
         $loaders = $this->validatorBuilder->getLoaders();
         $metadataFactory = new LazyLoadingMetadataFactory(new LoaderChain($loaders), $arrayAdapter);
diff --git a/src/Symfony/Bundle/FrameworkBundle/Command/CacheWarmupCommand.php b/src/Symfony/Bundle/FrameworkBundle/Command/CacheWarmupCommand.php
@@ -74,8 +74,7 @@ protected function execute(InputInterface $input, OutputInterface $output): int
 
         $preload = $this->cacheWarmer->warmUp($cacheDir);
 
-        $buildDir = $kernel->getContainer()->getParameter('kernel.build_dir');
-        if ($preload && $cacheDir === $buildDir && file_exists($preloadFile = $buildDir.'/'.$kernel->getContainer()->getParameter('kernel.container_class').'.preload.php')) {
+        if ($preload && file_exists($preloadFile = $kernel->getContainer()->getParameter('kernel.build_dir').'/'.$kernel->getContainer()->getParameter('kernel.container_class').'.preload.php')) {
             Preloader::append($preloadFile, $preload);
         }
 
diff --git a/src/Symfony/Bundle/FrameworkBundle/Routing/Router.php b/src/Symfony/Bundle/FrameworkBundle/Routing/Router.php
@@ -81,9 +81,9 @@ public function getRouteCollection(): RouteCollection
     }
 
     /**
-     * @return string[] A list of classes to preload on PHP 7.4+
+     * @param string|null $buildDir
      */
-    public function warmUp(string $cacheDir): array
+    public function warmUp(string $cacheDir /* , string $buildDir = null */): array
     {
         $currentDir = $this->getOption('cache_dir');
 
diff --git a/src/Symfony/Bundle/FrameworkBundle/Tests/Command/CacheClearCommand/Fixture/TestAppKernel.php b/src/Symfony/Bundle/FrameworkBundle/Tests/Command/CacheClearCommand/Fixture/TestAppKernel.php
@@ -52,7 +52,7 @@ public function isOptional(): bool
         return false;
     }
 
-    public function warmUp(string $cacheDir): array
+    public function warmUp(string $cacheDir, string $buildDir = null): array
     {
         file_put_contents($cacheDir.'/dummy.txt', 'Hello');
 
diff --git a/src/Symfony/Bundle/FrameworkBundle/Translation/Translator.php b/src/Symfony/Bundle/FrameworkBundle/Translation/Translator.php
@@ -95,9 +95,9 @@ public function __construct(ContainerInterface $container, MessageFormatterInter
     }
 
     /**
-     * @return string[]
+     * @param string|null $buildDir
      */
-    public function warmUp(string $cacheDir): array
+    public function warmUp(string $cacheDir /* , string $buildDir = null */): array
     {
         // skip warmUp when translator doesn't use cache
         if (null === $this->options['cache_dir']) {
diff --git a/src/Symfony/Bundle/SecurityBundle/CacheWarmer/ExpressionCacheWarmer.php b/src/Symfony/Bundle/SecurityBundle/CacheWarmer/ExpressionCacheWarmer.php
@@ -35,9 +35,9 @@ public function isOptional(): bool
     }
 
     /**
-     * @return string[]
+     * @param string|null $buildDir
      */
-    public function warmUp(string $cacheDir): array
+    public function warmUp(string $cacheDir /* , string $buildDir = null */): array
     {
         foreach ($this->expressions as $expression) {
             $this->expressionLanguage->parse($expression, ['token', 'user', 'object', 'subject', 'role_names', 'request', 'trust_resolver']);
diff --git a/src/Symfony/Bundle/TwigBundle/CacheWarmer/TemplateCacheWarmer.php b/src/Symfony/Bundle/TwigBundle/CacheWarmer/TemplateCacheWarmer.php
@@ -36,9 +36,9 @@ public function __construct(ContainerInterface $container, iterable $iterator)
     }
 
     /**
-     * @return string[] A list of template files to preload on PHP 7.4+
+     * @param string|null $buildDir
      */
-    public function warmUp(string $cacheDir): array
+    public function warmUp(string $cacheDir /* , string $buildDir = null */): array
     {
         $this->twig ??= $this->container->get('twig');
 
diff --git a/src/Symfony/Component/HttpKernel/Tests/CacheWarmer/CacheWarmerTest.php b/src/Symfony/Component/HttpKernel/Tests/CacheWarmer/CacheWarmerTest.php
@@ -54,7 +54,7 @@ public function __construct(string $file)
         $this->file = $file;
     }
 
-    public function warmUp(string $cacheDir): array
+    public function warmUp(string $cacheDir, string $buildDir = null): array
     {
         $this->writeCacheFile($this->file, 'content');
 
diff --git a/src/Symfony/Component/Serializer/CacheWarmer/CompiledClassMetadataCacheWarmer.php b/src/Symfony/Component/Serializer/CacheWarmer/CompiledClassMetadataCacheWarmer.php
@@ -29,7 +29,7 @@ public function __construct(
     ) {
     }
 
-    public function warmUp(string $cacheDir): array
+    public function warmUp(string $cacheDir, string $buildDir = null): array
     {
         $metadatas = [];
 
diff --git a/src/Symfony/Component/Translation/DataCollectorTranslator.php b/src/Symfony/Component/Translation/DataCollectorTranslator.php
@@ -72,12 +72,14 @@ public function getCatalogues(): array
     }
 
     /**
-     * @return string[]
+     * @param string|null $buildDir
      */
-    public function warmUp(string $cacheDir): array
+    public function warmUp(string $cacheDir /* , string $buildDir = null */): array
     {
+        $buildDir = 1 < \func_num_args() ? func_get_arg(1) : null;
+
         if ($this->translator instanceof WarmableInterface) {
-            return (array) $this->translator->warmUp($cacheDir);
+            return (array) $this->translator->warmUp($cacheDir, $buildDir);
         }
 
         return [];

Original file line number	Diff line number	Diff line change
`@@ -38,9 +38,9 @@ public function isOptional(): bool`
`38`	`38`	`}`
`39`	`39`
`40`	`40`	`/**`
`41`		`- * @return string[] A list of files to preload on PHP 7.4+`
	`41`	`+ * @param string\|null $buildDir`
`42`	`42`	`*/`
`43`		`- public function warmUp(string $cacheDir): array`
	`43`	`+ public function warmUp(string $cacheDir /* , string $buildDir = null */): array`
`44`	`44`	`{`
`45`	`45`	`$files = [];`
`46`	`46`	`foreach ($this->registry->getManagers() as $em) {`
Original file line number	Diff line number	Diff line change
`@@ -35,15 +35,16 @@ public function isOptional(): bool`
`35`	`35`	`}`
`36`	`36`
`37`	`37`	`/**`
`38`		`- * @return string[] A list of classes to preload on PHP 7.4+`
	`38`	`+ * @param string\|null $buildDir`
`39`	`39`	`*/`
`40`		`- public function warmUp(string $cacheDir): array`
	`40`	`+ public function warmUp(string $cacheDir /* , string $buildDir = null */): array`
`41`	`41`	`{`
	`42`	`+ $buildDir = 1 < \func_num_args() ? func_get_arg(1) : null;`
`42`	`43`	`$arrayAdapter = new ArrayAdapter();`
`43`	`44`
`44`	`45`	`spl_autoload_register([ClassExistenceResource::class, 'throwOnRequiredClass']);`
`45`	`46`	`try {`
`46`		`- if (!$this->doWarmUp($cacheDir, $arrayAdapter)) {`
	`47`	`+ if (!$this->doWarmUp($cacheDir, $arrayAdapter, $buildDir)) {`
`47`	`48`	`return [];`
`48`	`49`	`}`
`49`	`50`	`} finally {`
`@@ -78,7 +79,9 @@ final protected function ignoreAutoloadException(string $class, \Exception $exce`
`78`	`79`	`}`
`79`	`80`
`80`	`81`	`/**`
	`82`	`+ * @param string\|null $buildDir`
	`83`	`+ *`
`81`	`84`	`* @return bool false if there is nothing to warm-up`
`82`	`85`	`*/`
`83`		`- abstract protected function doWarmUp(string $cacheDir, ArrayAdapter $arrayAdapter): bool;`
	`86`	`+ abstract protected function doWarmUp(string $cacheDir, ArrayAdapter $arrayAdapter /* , string $buildDir = null */): bool;`
`84`	`87`	`}`
Original file line number	Diff line number	Diff line change
`@@ -44,7 +44,10 @@ public function __construct(`
`44`	`44`	`parent::__construct($phpArrayFile);`
`45`	`45`	`}`
`46`	`46`
`47`		`- protected function doWarmUp(string $cacheDir, ArrayAdapter $arrayAdapter): bool`
	`47`	`+ /**`
	`48`	`+ * @param string\|null $buildDir`
	`49`	`+ */`
	`50`	`+ protected function doWarmUp(string $cacheDir, ArrayAdapter $arrayAdapter /* , string $buildDir = null */): bool`
`48`	`51`	`{`
`49`	`52`	`$annotatedClassPatterns = $cacheDir.'/annotations.map';`
`50`	`53`
Original file line number	Diff line number	Diff line change
`@@ -37,10 +37,7 @@ public function __construct(Psr6CacheClearer $poolClearer, array $pools = [])`
`37`	`37`	`$this->pools = $pools;`
`38`	`38`	`}`
`39`	`39`
`40`		`- /**`
`41`		`- * @return string[]`
`42`		`- */`
`43`		`- public function warmUp(string $cacheDirectory): array`
	`40`	`+ public function warmUp(string $cacheDir, string $buildDir = null): array`
`44`	`41`	`{`
`45`	`42`	`foreach ($this->pools as $pool) {`
`46`	`43`	`if ($this->poolClearer->hasPool($pool)) {`
Original file line number	Diff line number	Diff line change
`@@ -34,12 +34,12 @@ public function __construct(ContainerInterface $container)`
`34`	`34`	`$this->container = $container;`
`35`	`35`	`}`
`36`	`36`
`37`		`- public function warmUp(string $cacheDir): array`
	`37`	`+ public function warmUp(string $cacheDir, string $buildDir = null): array`
`38`	`38`	`{`
`39`	`39`	`$router = $this->container->get('router');`
`40`	`40`
`41`	`41`	`if ($router instanceof WarmableInterface) {`
`42`		`- return (array) $router->warmUp($cacheDir);`
	`42`	`+ return (array) $router->warmUp($cacheDir, $buildDir);`
`43`	`43`	`}`
`44`	`44`
`45`	`45`	`throw new \LogicException(sprintf('The router "%s" cannot be warmed up because it does not implement "%s".', get_debug_type($router), WarmableInterface::class));`
Original file line number	Diff line number	Diff line change
`@@ -39,7 +39,10 @@ public function __construct(array $loaders, string $phpArrayFile)`
`39`	`39`	`$this->loaders = $loaders;`
`40`	`40`	`}`
`41`	`41`
`42`		`- protected function doWarmUp(string $cacheDir, ArrayAdapter $arrayAdapter): bool`
	`42`	`+ /**`
	`43`	`+ * @param string\|null $buildDir`
	`44`	`+ */`
	`45`	`+ protected function doWarmUp(string $cacheDir, ArrayAdapter $arrayAdapter /* , string $buildDir = null */): bool`
`43`	`46`	`{`
`44`	`47`	`if (!$this->loaders) {`
`45`	`48`	`return true;`
Original file line number	Diff line number	Diff line change
`@@ -34,14 +34,16 @@ public function __construct(ContainerInterface $container)`
`34`	`34`	`}`
`35`	`35`
`36`	`36`	`/**`
`37`		`- * @return string[]`
	`37`	`+ * @param string\|null $buildDir`
`38`	`38`	`*/`
`39`		`- public function warmUp(string $cacheDir): array`
	`39`	`+ public function warmUp(string $cacheDir /* , string $buildDir = null */): array`
`40`	`40`	`{`
`41`	`41`	`$this->translator ??= $this->container->get('translator');`
`42`	`42`
`43`	`43`	`if ($this->translator instanceof WarmableInterface) {`
`44`		`- return (array) $this->translator->warmUp($cacheDir);`
	`44`	`+ $buildDir = 1 < \func_num_args() ? func_get_arg(1) : null;`
	`45`	`+`
	`46`	`+ return (array) $this->translator->warmUp($cacheDir, $buildDir);`
`45`	`47`	`}`
`46`	`48`
`47`	`49`	`return [];`
Original file line number	Diff line number	Diff line change
`@@ -74,8 +74,7 @@ protected function execute(InputInterface $input, OutputInterface $output): int`
`74`	`74`
`75`	`75`	`$preload = $this->cacheWarmer->warmUp($cacheDir);`
`76`	`76`
`77`		`- $buildDir = $kernel->getContainer()->getParameter('kernel.build_dir');`
`78`		`- if ($preload && $cacheDir === $buildDir && file_exists($preloadFile = $buildDir.'/'.$kernel->getContainer()->getParameter('kernel.container_class').'.preload.php')) {`
	`77`	`+ if ($preload && file_exists($preloadFile = $kernel->getContainer()->getParameter('kernel.build_dir').'/'.$kernel->getContainer()->getParameter('kernel.container_class').'.preload.php')) {`
`79`	`78`	`Preloader::append($preloadFile, $preload);`
`80`	`79`	`}`
`81`	`80`
Original file line number	Diff line number	Diff line change
`@@ -81,9 +81,9 @@ public function getRouteCollection(): RouteCollection`
`81`	`81`	`}`
`82`	`82`
`83`	`83`	`/**`
`84`		`- * @return string[] A list of classes to preload on PHP 7.4+`
	`84`	`+ * @param string\|null $buildDir`
`85`	`85`	`*/`
`86`		`- public function warmUp(string $cacheDir): array`
	`86`	`+ public function warmUp(string $cacheDir /* , string $buildDir = null */): array`
`87`	`87`	`{`
`88`	`88`	`$currentDir = $this->getOption('cache_dir');`
`89`	`89`