Benchmark large template parsing performance

Current results for parsing the large template 1000 times:

- JIT off: 191 seconds (191 ms/parse)
- JIT on: 90 seconds (90 ms/parse)

Author: theodorejb

composer.json

@@ -23,7 +23,7 @@
         "friendsofphp/php-cs-fixer": "^3.94",
         "ircmaxell/php-yacc": "dev-master",
         "jbboehr/handlebars-spec": "dev-master",
-        "phpstan/phpstan": "^2.1.38",
+        "phpstan/phpstan": "^2.1.40",
         "phpunit/phpunit": "^11.5"
     },
     "autoload": {

composer.lock

@@ -601,12 +601,12 @@ protected function preparePath(bool $data, ?SubExpression $sexpr, array $parts,
         $tail = [];
         $depth = 0;
 
-        for ($i = 0; $i < count($parts); $i++) {
-            $part = $parts[$i]->part;
+        foreach ($parts as $segment) {
+            $part = $segment->part;
             // If we have [] syntax then we do not treat path references as operators,
             // i.e. foo.[this] resolves to approximately context.foo['this']
-            $isLiteral = $parts[$i]->original !== $part;
-            $separator = $parts[$i]->separator;
+            $isLiteral = $segment->original !== $part;
+            $separator = $segment->separator;
 
             $partPrefix = $separator === '.#' ? '#' : '';
 

src/ParserAbstract.php

@@ -0,0 +1,45 @@
+<?php
+
+/**
+ * Parser benchmark script. Default iterations: 1000.
+ *
+ * Usage: php -d opcache.enable_cli=1 -d opcache.jit=tracing tests/benchmark.php
+ */
+
+use DevTheorem\HandlebarsParser\ParserFactory;
+
+require __DIR__ . '/../vendor/autoload.php';
+
+$iterations = (int) ($argv[1] ?? 1000);
+$filename = __DIR__ . "/largeTemplate.hbs";
+
+// A large, complex template exercising as many syntax features as possible.
+$template = file_get_contents($filename);
+if ($template === false) {
+    exit("Failed to open $filename");
+}
+
+$parser = (new ParserFactory())->create();
+
+// Warm up: give the JIT a chance to compile hot paths before we measure.
+for ($i = 0; $i < 50; $i++) {
+    $parser->parse($template);
+}
+
+$start = hrtime(true);
+
+for ($i = 0; $i < $iterations; $i++) {
+    $parser->parse($template);
+}
+
+$elapsed = (hrtime(true) - $start) / 1e9;
+$perParse = $elapsed / $iterations * 1000;
+$templateBytes = strlen($template);
+
+printf(
+    "Parsed %d times in %.3f s  |  %.3f ms/parse  |  %.1f KB template\n",
+    $iterations,
+    $elapsed,
+    $perParse,
+    $templateBytes / 1024,
+);