[2025-12-10T21:13:24.506728+00:00] request.CRITICAL: Uncaught PHP Exception Twig\Error\RuntimeError: 
"An exception has been thrown during the rendering of a template 
("Unable to write in the cache directory (/path/to/var/cache/prod/twig/96).")." 
at template.html.twig line 1

[previous exception] [object] (RuntimeException(code: 0): 
Unable to write in the cache directory (/path/to/var/cache/prod/twig/96). 
at /vendor/twig/twig/src/Cache/FilesystemCache.php:57)

<?php

namespace App\CacheWarmer;

use Symfony\Component\Finder\Finder;
use Symfony\Component\HttpKernel\CacheWarmer\CacheWarmerInterface;
use Symfony\Component\HttpKernel\KernelInterface;
use Twig\Environment;
use Twig\Error\Error;

/**
 * Automatically discovers and warms up original templates referenced with @! prefix.
 *
 * This cache warmer scans all template files in the templates/ directory for references
 * to original templates using the @! prefix (e.g., {% extends '@!Bundle/...' %}).
 * It then explicitly compiles those original templates during cache warmup.
 *
 * This solves the issue where Symfony's default cache warmer only discovers templates
 * that exist as files, but doesn't follow @! references inside those templates.
 */
class AutoDiscoverOriginalTemplateCacheWarmer implements CacheWarmerInterface
{
    /**
     * Regex pattern to find @! template references in Twig files.
     * Matches patterns like:
     * - {% extends '@!Bundle/path/to/template.html.twig' %}
     * - {% include '@!Bundle/path/to/template.html.twig' %}
     * - {% embed '@!Bundle/path/to/template.html.twig' %}
     * - {% use '@!Bundle/path/to/template.html.twig' %}
     */
    private const ORIGINAL_TEMPLATE_PATTERN = '/@!([A-Za-z0-9_]+)\/([A-Za-z0-9_\/\.\-]+\.twig)/';

    public function __construct(
        private Environment $twig,
        private KernelInterface $kernel
    ) {
    }

    public function warmUp(string $cacheDir, ?string $buildDir = null): array
    {
        $originalTemplates = $this->findOriginalTemplateReferences();

        foreach ($originalTemplates as $template) {
            try {
                $this->twig->load($template);
            } catch (Error $e) {
                // Ignore compilation errors - template might not exist or have syntax errors
                // This is consistent with how TemplateCacheWarmer handles errors
            }
        }

        return [];
    }

    public function isOptional(): bool
    {
        return true;
    }

    /**
     * Scans all template files in the templates/ directory and extracts @! references.
     *
     * @return array<string> Array of unique template names with @! prefix
     */
    private function findOriginalTemplateReferences(): array
    {
        $originalTemplates = [];
        $templatesDir = $this->kernel->getProjectDir() . '/templates';

        if (!is_dir($templatesDir)) {
            return [];
        }

        $finder = Finder::create()
            ->files()
            ->in($templatesDir)
            ->name('*.twig')
            ->ignoreUnreadableDirs();

        foreach ($finder as $file) {
            $content = $file->getContents();

            // Find all @! template references in this file
            if (preg_match_all(self::ORIGINAL_TEMPLATE_PATTERN, $content, $matches, PREG_SET_ORDER)) {
                foreach ($matches as $match) {
                    // Reconstruct the full template name: @!Bundle/path/to/template.twig
                    $templateName = '@!' . $match[1] . '/' . $match[2];
                    $originalTemplates[$templateName] = true;
                }
            }
        }

        return array_keys($originalTemplates);
    }
}