Download the PHP package smartive/handlebars-bundle without Composer

SmartiveHandlebarsBundle

Bundle to integrate Handlebars templates into your Symfony2 / Symfony3 application.

This bundle renders handlebars with the help of xamin/handlebars.php.

Installation

Require the smartive/handlebars-bundle package in your composer.json and update your dependencies.

Register the bundle in app/AppKernel.php:

Configuration

Some of the features can be configured in the smartive_handlebars section of app/config/config.yml.

Handlebars file extension

The default file extension for Handlebars files is set to .hbs. This can be overridden using the following setting (example file extension set to .handlebars):

Template directories

The template_directories setting lets you define where to look for Handlebars templates. You can use Symfony resource notation as well as absolute file paths to configure directories.

By default, templates are getting search for in template directories recursively. You can disable this behaviour as follows:

Twig extension

The Handlebars Twig extension is enabled by default. To disable it add this to your configuration:

Usage

Rendering service

The smartive_handlebars.templating.renderer service offers a render($templateName, $data) method which can be use to render Handlebars templates.

Twig

To render Handlebars templates in Twig you can use the Twig function handlebars(templateName, data).

Custom Handlebars helpers

You can add you own Handlebars helpers as tagged services by implementing the Handlebars\Helper interface. To find out more about how to write custom helpers please have a look at the built-in helpers by xamin/handlebars.php.

Once you've implemented your own helper you have to register it as a service using the smartive_handlebars.helper tag and an appropriate alias:

You now can use your custom Handlebars helper inside your templates as follows:

Caching

The rendering service offers the ability to cache the parsed template between requests for faster rendering.

You can enable caching by setting smartive_handlebars.cache to a existing cache service ID in your app/config/config.yml:

There are several caching services / strategies available per default:

Disk

Service ID: smartive_handlebars.cache.disk

Uses Handlebars\Cache\Disk to read/write file cache in Symfony's cache directory

APC

Service ID: smartive_handlebars.cache.apc

Uses Handlebars\Cache\APC to read/write cache objects using APC

Redis

Service ID: smartive_handlebars.cache.redis

Uses PhpRedis or Predis to read/write cache objects using a Redis Server. This bundle integrates with RedisBundle in order to make configuring your Redis implementation even easier. The default Redis client being used is snc_redis.default (see RedisBundle documentation).

The default configuration can be overridden looks as follows:

Custom

You can also define your own caching services by adding a class which implements Handlebars\Cache. To use your custom cache service you have to register it in your service configuration:

Complete configuration example