Cache parser and compiler instances

This reduces memory usage by over 30%, and when compiling multiple templates improves performance by up to 20%.

Author: theodorejb

composer.json

@@ -19,12 +19,12 @@
     ],
     "require": {
         "php": ">=8.2",
-        "devtheorem/php-handlebars-parser": "^1.1.1"
+        "devtheorem/php-handlebars-parser": "^2.0"
     },
     "require-dev": {
         "friendsofphp/php-cs-fixer": "^3.94",
         "jbboehr/handlebars-spec": "dev-master",
-        "phpstan/phpstan": "^2.1.44",
+        "phpstan/phpstan": "^2.1.46",
         "phpunit/phpunit": "^11.5"
     },
     "autoload": {

composer.lock

@@ -725,7 +725,7 @@ private function compilePartialTemplate(string $name, string $template): void
             return;
         }
 
-        $program = $this->parser->parse($template);
+        $program = $this->parser->parse($template, $this->context->options->ignoreStandalone);
         $code = (new Compiler($this->parser))->compile($program, $this->context);
 
         $this->context->partialCode[$name] = self::quote($name) . ' => ' . self::templateClosure($code);

src/Compiler.php

@@ -3,6 +3,7 @@
 namespace DevTheorem\Handlebars;
 
 use Closure;
+use DevTheorem\HandlebarsParser\Parser;
 use DevTheorem\HandlebarsParser\ParserFactory;
 
 /**
@@ -11,6 +12,9 @@
  */
 final class Handlebars
 {
+    private static ?Parser $parser = null;
+    private static ?Compiler $compiler = null;
+
     /**
      * Compiles a template so it can be executed immediately.
      * @return Template
@@ -25,15 +29,15 @@ public static function compile(string $template, Options $options = new Options(
      */
     public static function precompile(string $template, Options $options = new Options()): string
     {
+        self::$parser ??= (new ParserFactory())->create();
+        self::$compiler ??= new Compiler(self::$parser);
+
         $context = new Context($options);
-        $parser = (new ParserFactory())->create($options->ignoreStandalone);
-        $program = $parser->parse($template);
-        $compiler = new Compiler($parser);
-        $code = $compiler->compile($program, $context);
-        $compiler->handleDynamicPartials();
+        $program = self::$parser->parse($template, $options->ignoreStandalone);
+        $code = self::$compiler->compile($program, $context);
+        self::$compiler->handleDynamicPartials();
 
-        // return full PHP render code as string
-        return $compiler->composePHPRender($code);
+        return self::$compiler->composePHPRender($code);
     }
 
     /**