devtheorem/php-handlebars-parser

Parse Handlebars templates to a spec-compliant AST with PHP.

v2.0.0 2026-04-02 16:25 UTC

Requires

• php: >=8.2

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.94
• ircmaxell/php-yacc: dev-master
• jbboehr/handlebars-spec: dev-master
• phpstan/phpstan: ^2.1.46
• phpunit/phpunit: ^11.5

MIT

• Theodore Brown

• php
• template
• parse
• ast
• handlebars

README

Parse Handlebars templates to a spec-compliant AST with PHP.

Implements the same lexical analysis and grammar specification as Handlebars.js, so any template which can (or cannot) be parsed by Handlebars.js should parse (or error) the same way here.

Note

This project is only a parser. To compile Handlebars templates to native PHP for execution, see PHP Handlebars, which uses this parser.

Installation

composer require devtheorem/php-handlebars-parser

Usage

use DevTheorem\HandlebarsParser\ParserFactory;

$parser = (new ParserFactory())->create();

$template = "Hello {{name}}!";

$result = $parser->parse($template);

If the template contains invalid syntax, an exception will be thrown. Otherwise, $result will contain a DevTheorem\HandlebarsParser\Ast\Program instance.

Whitespace handling

The ignoreStandalone Handlebars compilation option can be passed to parse():

$result = $parser->parse($template, ignoreStandalone: true);

Author

Theodore Brown
https://theodorejb.me