devtheorem/php-handlebars-parser

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

v1.0.0 2026-02-20 15:20 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.38
• 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 parser can be created with an optional boolean argument, to support the ignoreStandalone Handlebars compilation option:

$parser = (new ParserFactory())->create(ignoreStandalone: true);

Author

Theodore Brown
https://theodorejb.me