[Cache] Cache the parsed entrypoints.json

Author: Kocal

.gitignore

@@ -23,3 +23,6 @@ node_modules/
 
 # PHP-CS-Fixer
 /.php-cs-fixer.cache
+
+# Symfony config-builder reference, regenerated by the test kernel's cache warmer.
+/config/reference.php

.php-cs-fixer.dist.php

@@ -59,7 +59,7 @@ public function getRuleCustomisers(): array
                     $relativePathname = $file->getRelativePathname();
 
                     if (
-                        str_contains($relativePathname, '/tests/') // don't touch test files, as massive change with little benefit - as outside of public contract anyway
+                        str_contains($relativePathname, 'tests/') // don't touch test files, as massive change with little benefit - as outside of public contract anyway
                         || str_contains($relativePathname, '/Test/') // public namespace not following the rule, do not mistake it with `/Tests/`
                     ) {
                         return false;

composer.json

@@ -24,7 +24,9 @@
         "phpunit/phpunit": "^13.2",
         "phpstan/phpstan": "^2.2",
         "friendsofphp/php-cs-fixer": "^3.95",
-        "symfony/web-link": "^7.4|^8.0"
+        "symfony/web-link": "^7.4|^8.0",
+        "symfony/cache": "^7.4|^8.0",
+        "symfony/var-exporter": "^7.4|^8.0"
     },
     "autoload": {
         "psr-4": { "Symfony\\Reprise\\": "src/" }

config/cache.php

@@ -0,0 +1,40 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+use Symfony\Component\Cache\Adapter\PhpArrayAdapter;
+use Symfony\Reprise\CacheWarmer\EntrypointsCacheWarmer;
+
+return static function (ContainerConfigurator $container): void {
+    $services = $container->services();
+
+    $services->set('cache.reprise')
+        ->parent('cache.system')
+        ->tag('cache.pool')
+    ;
+
+    $services->set('reprise.cache', PhpArrayAdapter::class)
+        ->args([
+            '%kernel.build_dir%/reprise.cache.php',
+            service('cache.reprise'),
+        ])
+    ;
+
+    $services->set('reprise.entrypoints_cache_warmer', EntrypointsCacheWarmer::class)
+        ->args([
+            param('reprise.entrypoints_path'),
+            'reprise.entrypoints',
+            service('reprise.cache'),
+        ])
+        ->tag('kernel.cache_warmer')
+    ;
+};

doc/index.rst

@@ -154,6 +154,9 @@ Reprise exposes a few optional settings under its own configuration, all shown h
         # Throw when entrypoints.json or a requested entry is missing, instead of rendering nothing.
         strict_mode: true
 
+        # Cache the parsed entrypoints.json in a compiled PHP file, warmed at cache:warmup (needs symfony/cache).
+        cache: false
+
         # A framework.assets package name used to resolve entry URLs. null uses the default package.
         asset_package: null
 
@@ -171,6 +174,9 @@ Reprise exposes a few optional settings under its own configuration, all shown h
   own ``outputPath``.
 - ``strict_mode``: when ``true`` (the default), throws a clear exception on a missing file or an unknown entry; when
   ``false``, renders nothing instead.
+- ``cache``: when ``true``, parse ``entrypoints.json`` once at ``cache:warmup`` and read it from a compiled PHP file
+  at runtime instead of decoding the JSON on every request. Enable it in production and run ``cache:clear`` after
+  rebuilding your assets; it needs ``symfony/cache`` (``composer require symfony/cache``).
 - ``asset_package``: resolve entry URLs through a specific ``framework.assets`` package instead of the default one.
   You only need this if your default package applies a version strategy, which would re-hash files Reprise already
   content-hashed and break the URLs. Point it at a package with ``version: false`` (see below).