igorw-forks / mustache-silex-provider

Mustache integration for the Silex application micro-framework.

MustacheServiceProvider

MustacheServiceProvider provides Mustache integration for the Silex application micro-framework.

Installation

Add mustache/silex-provider to your project's composer.json:

{
    "require": {
        "mustache/silex-provider": "*"
    }
}

And install:

php composer.phar install

Configuration

• mustache.path (optional): Path to the directory containing Mustache template files.

• mustache.partials_path (optional): Path to the directory containing Mustache partial template files. If none is specified, this will default to mustache.path.

• mustache.partials (optional): An associative array of template names to template contents. Use this if you want to define partials inline.

• mustache.options (optional): An associative array of Mustache options. See the Mustache.php documentation for more information.

Services

• mustache.loader (optional): A Mustache template loader instance. This loader will use the mustache.path option you provided. You can also replace the loader with something awesome of your own.

• mustache.partials_loader (optional): The Mustache template loader used to load partials. By default, this will load templates from either your the mustache.partials_path or mustache.partials configuration options. You can also replace the partials loader with another loader of your choice.

Registering

<?php

$app->register(new Mustache\Silex\Provider\MustacheServiceProvider, array(
    'mustache.path' => __DIR__.'/../views',
    'mustache.options' => array(
        'cache' => __DIR__.'/../tmp/cache/mustache',
    ),
));

Usage

The Mustache provider provides a mustache service:

<?php

$app->get('/hello/{name}', function ($name) use($app) {
    return $app['mustache']->render('hello', array(
        'name' => ucfirst($name),
    ));
});

This will render the hello.mustache file from your application's views directory.

The Trait

Mustache\Silex\Application\MustacheTrait adds a render helper to your app:

<?php

return $app->render('hello', array('name' => 'Justin'));

$response = new Response;
$response->setTtl(10);

return $app->render('hello', array('name' => 'Justin'), $response);

It also provides a renderTemplate helper which returns a rendered string instead of a Response object.

Customization

You can mess with Mustache before using it by extending the mustache service:

<?php

$app['mustache'] = $app->share($app->extend('mustache', function ($mustache, $app) {
    $mustache->addHelper('app', $app);
    $mustache->setLogger($app['monolog']);

    return $mustache;
}));