Keine Beschreibung

Justin Hileman 5400cd91a0 Removing now-deprecated HandlebarMustache class. vor 15 Jahren
examples 1ede993bb3 Added double section, escaped output, utf8 escaped and utf8 unescaped examples. vor 15 Jahren
test 3108aff56d fixing documentation for unit tests vor 15 Jahren
LICENSE 36bd2d87dc MIT License vor 15 Jahren
Mustache.php 4baf602eab Updated default character escaping for UTF-8 compatibility. For other character sets, or to disable UTF-8 support entirely, change the 'charset' property or renderEscaped method on subclasses. vor 15 Jahren
README.markdown fa8c81dcfd Update README to reflect preferred mustache class implementation. Rendering arbitrary generic view class/array and template is secondary. vor 15 Jahren
TraversableMustache.php 88f67fc53e added notes on purpose of the mustache subclasses. vor 15 Jahren

README.markdown

Mustache.php

A Mustache implementation in PHP.

Usage

A quick example:

<?php
include('Mustache.php');
$m = new Mustache;
echo $m->render('Hello {{planet}}', array('planet' => 'World!'));
// "Hello World!"
?>

And a more in-depth example--this is the canonical Mustache template:

Hello {{name}}
You have just won ${{value}}!
{{#in_ca}}
Well, ${{taxed_value}}, after taxes.
{{/in_ca}}

Along with the associated Mustache class:

<?php
class Chris extends Mustache {
    public $name = "Chris";
    public $value = 10000;

    public function taxed_value() {
        return $this->value - ($this->value * 0.4);
    }

    public $in_ca = true;
}

Render it like so:

<?php
$c = new Chris;
echo $chris->render($template);
?>

Here's the same thing, a different way:

Create a view object--which could also be an associative array, but those don't do functions quite as well:

<?php
class Chris {
    public $name = "Chris";
    public $value = 10000;

    public function taxed_value() {
        return $this->value - ($this->value * 0.4);
    }

    public $in_ca = true;
}
?>

And render it:

<?php
$chris = new Chris;
$m = new Mustache;
echo $m->render($template, $chris);
?>

Known Issues

  • Sections don't respect delimiter changes -- delimiters example currently fails with an "unclosed section" exception.
  • Since complex example emulates some fancy swizzling available in Ruby, it fails. Need to convert example to PHPisms (In PHP, Mustache class doesn't maintain current context stack -- available context is passed to methods via params).
  • Test coverage is incomplete.

See Also