PHPackages                             mervick/yii2-mthaml - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Templating & Views](/categories/templating)
4. /
5. mervick/yii2-mthaml

ActiveYii2-extension[Templating & Views](/categories/templating)

mervick/yii2-mthaml
===================

The MtHaml integration for the Yii2 framework

0.1.3(11y ago)71.2k1[6 issues](https://github.com/mervick/yii2-mthaml/issues)MITPHPPHP >=5.4.0

Since Feb 2Pushed 10y ago1 watchersCompare

[ Source](https://github.com/mervick/yii2-mthaml)[ Packagist](https://packagist.org/packages/mervick/yii2-mthaml)[ RSS](/packages/mervick-yii2-mthaml/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (16)Versions (3)Used By (0)

Yii2 MtHaml
===========

[](#yii2-mthaml)

[![Analytics](https://camo.githubusercontent.com/2a1b849c40a491bda73164b61dd9a671a4a17f2270320b4e32ae8ce2161e9013/68747470733a2f2f67612d626561636f6e2e61707073706f742e636f6d2f55412d36353239353237352d312f796969322d6d7468616d6c)](https://github.com/igrigorik/ga-beacon)

The MtHaml integration for the Yii2 framework.
Extension provides a `ViewRenders` that would allow you to use Haml/Twig view template engines, using [Multi target HAML (MtHaml)](https://github.com/arnaud-lb/MtHaml) library.

Requirements
------------

[](#requirements)

- YII 2.0
- PHP 5.4+
- Composer

Installation with Composer
--------------------------

[](#installation-with-composer)

Installation is recommended to be done via [composer](https://getcomposer.org) by running:

```
composer require mervick/yii2-mthaml "*"
```

Also for using twig:

```
composer require twig/twig "~1.11"
```

Usage
-----

[](#usage)

Add this to your `config/main.php` file:

```
return [
    //....
    'components' => [
        'view' => [
            'renderers' => [
                'haml' => [
                    'class' => 'mervick\mthaml\HamlViewRenderer',
                ],
                'twig' => [
                    'class' => 'mervick\mthaml\TwigViewRenderer',
                ],
            ],
        ],
    ],
];
```

Rendering in Controllers:

```
class SiteController extends Controller
{
    //....
    public function actionIndex()
    {
        return $this->render('index.haml', $params);
        // or if your want to use twig
        // return $this->render('index.twig', $params);
    }
    //....
}
```

MtHaml Options
--------------

[](#mthaml-options)

This is default options:

```
    //....
    'renderers' => [
        'haml' => [
            'class' => 'mervick\mthaml\HamlViewRenderer',
            'cachePath' => '@runtime/Haml/cache',
            'debug' => false,
            'options' => [
                'format' => 'html5',
                // MtHaml escapes everything by default
                'enable_escaper' => true,
                'escape_html' => true,
                'escape_attrs' => true,
                'cdata' => true,
                'autoclose' => array('meta', 'img', 'link', 'br', 'hr', 'input', 'area', 'param', 'col', 'base'),
                'charset' => 'UTF-8',
                'enable_dynamic_attrs' => true,
            ],
        ],
        'twig' => [
            'class' => 'mervick\mthaml\TwigViewRenderer',
            'cachePath' => '@runtime/Twig/cache',
            'debug' => false,
            'options' => [
                // Same as for haml, except "enable_escaper"
                // Twig extension already supports auto escaping, so it turned off for MtHaml
                'enable_escaper' => false,
            ],
        ],
    //....
```

Filters
-------

[](#filters)

Filters take plain text input (with support for `#{...}` interpolations) and transform it, or wrap it. [Learn more](https://github.com/arnaud-lb/MtHaml#filters)

The following filters are available by default:

- `css`: wraps with style tags
- `cdata`: wraps with CDATA markup
- `escaped`: html escapes
- `javascript`: wraps with script tags
- `php`: executes the input as php code
- `plain`: renders as plain text
- `preserve`: preserves preformatted text

Filters which not enabled by default:

- `coffee`: compiles coffeescript to javascript
    - dependence `coffeescript/coffeescript "~1"` (CoffeeScript)
- `less`: compiles as Lesscss
    - depends one of following:
        `oyejorge/less.php "*"` (OyejorgeLess)
        or `leafo/lessphp "*"` (LeafoLess)
- `scss`: converts scss to css
    - dependence `leafo/scssphp "*"` (Scss)
        additionally, to use [Compass](http://compass-style.org/) `leafo/scssphp-compass "dev-master"`
- `markdown`: converts markdown to html
    - depends one of following:
        `michelf/php-markdown "~1.3"` (MichelfMarkdown, MichelfMarkdownExtra)
        or `cebe/markdown "~1.0.1"` (CebeMarkdown, CebeMarkdownExtra, CebeGithubMarkdown)
        or `erusev/parsedown "*"` (Parsedown)
        or `league/commonmark ">=0.5"` (CommonMark)
        or `kzykhys/ciconia "~1"` (CiconiaMarkdown)
        or `fluxbb/commonmark "~1@dev"` (FluxBBMarkdown)
- `rest`: converts reStructuredText to html
    - dependence `gregwar/rst "~1"` (ReST)

To enable non default filters you must first install them via composer.
Example, install coffee filter:

```
composer require coffeescript/coffeescript "~1"
```

After what include it in your config file:

```
    //....
    'renderers' => [
        'haml' => [
            'class' => 'mervick\mthaml\HamlViewRenderer',
            'cachePath' => '@runtime/Haml/cache',
            'options' => [
                //....
            ],
            'filters' => [
                // shorten
                'coffee' => 'CoffeeScript',
                // also you can specify filter options
                'coffee' => [
                    'filter' => 'CoffeeScript',
                    'options' => [
                        'header' => false,
                        'trace' => '@runtime/Haml/coffee-trace.log',
                    ],
                ],
            ],
        ],
    //....
```

List of all the filters with default options:

```
    'coffee' => [
        // Package: "coffeescript/coffeescript"
        'filter' => 'CoffeeScript',
        'options' => [
            // add a "Generated by..." header
            'header' => true,
            // reference to token stream (debugging)
            'tokens' => null,
            // file to write parser trace to (debugging)
            'trace' => null,
        ],
    ],

    'less' => [
        // Package: "oyejorge/less.php"
        'filter' => 'OyejorgeLess',
        'options' => [
            // whether to compress
            'compress' => false,
            // whether units need to evaluate correctly
            'strictUnits' => false,
            // whether math has to be within parenthesis
            'strictMath' => false,
            // option - whether to adjust URL's to be relative
            'relativeUrls' => true,
            // whether to add args into url tokens
            'urlArgs' => [],
            'numPrecision' => 8,
            // import dirs
            'importDirs' => [],
            // cache dir
            'cacheDir' => null
        ],
    ],

    'less' => [
        // Package: "leafo/lessphp"
        'filter' => 'LeafoLess',
        'options' => [
            // import dirs
            'importDirs' => [],
        ],
    ],

    'scss' => [
        // Package: "leafo/scssphp"
        'filter' => 'Scss',
        'options' => [
            // import dirs
            'importDirs' => [],
            // enable Compass integration, depends on "leafo/scssphp-compass"
            'enableCompass' => false,
        ],
    ],

    'markdown' => [
        // Package: "michelf/php-markdown"
        'filter' => 'MichelfMarkdown',
        'options' => [
            'forceOptimization' => false,
            'empty_element_suffix' => " />",
            'tab_width' => 4,
            'no_markup' => false,
            'no_entities' => false,
            'predef_urls' => [],
            'predef_titles' => [],
        ],
    ],

    'markdown' => [
        // Package: "michelf/php-markdown"
        'filter' => 'MichelfMarkdownExtra',
        'options' => [
            // Same as for MichelfMarkdown
        ],
    ],

    'markdown' => [
        // Package: "cebe/markdown"
        'filter' => 'CebeMarkdown',
        'options' => [
            'forceOptimization' => false,
            'html5' => false,
        ],
    ],

    'markdown' => [
        // Package: "cebe/markdown"
        'filter' => 'CebeMarkdownExtra',
        'options' => [
            'forceOptimization' => false,
            'html5' => false,
        ],
    ],

    'markdown' => [
        // Package: "cebe/markdown"
        'filter' => 'CebeGithubMarkdown',
        'options' => [
            'forceOptimization' => false,
            'html5' => false,
            'enableNewlines' => false,
        ],
    ],

    'markdown' => [
        // Package: "kzykhys/ciconia"
        'filter' => 'CiconiaMarkdown',
        'options' => [
            'forceOptimization' => false,
            'tabWidth' => 4,
            'nestedTagLevel' => 3,
            'strict' => false,
        ],
    ],

    'markdown' => [
        // Package: "league/commonmark"
        'filter' => 'CommonMark',
        'options' => [
            'forceOptimization' => false,
        ],
    ],

    'markdown' => [
        // Package: "fluxbb/commonmark"
        'filter' => 'FluxBBMarkdown',
        'options' => [
            'forceOptimization' => false,
        ],
    ],

    'markdown' => [
        // Package: "erusev/parsedown"
        'filter' => 'Parsedown',
        'options' => [
            'forceOptimization' => false,
        ],
    ],

    'rest' => [
        // Package: "gregwar/rst"
        'filter' => 'ReST',
        // no options
    ],
```

Twig Extensions
---------------

[](#twig-extensions)

The [Twig Extensions](http://twig.sensiolabs.org/doc/extensions/index.html) is a library that provides several useful extensions for Twig.

Install via Composer:

```
composer require twig/extensions "~1.1.0"
```

Add the following lines to config file:

```
    //....
    'renderers' => [
        'twig' => [
            'class' => 'mervick\mthaml\TwigViewRenderer',
            'options' => [
                //...
            ],
            'extensions' => [
                'Text',   # Provides useful filters for text manipulation;
                'I18n',   # Adds internationalization support via the gettext library;
                'Intl',   # Adds a filter for localization of DateTime objects;
                'Array',  # Provides useful filters for array manipulation;
                'Date',   # Adds a filter for rendering the difference between dates.
            ],
        ],
    //....
```

Attention!
----------

[](#attention)

Inside the templates you must use `$view` instead of `$this`, example:

```
-use backend\assets\AppAsset
-use yii\helpers\Html

-AppAsset::register($view)
-$view->beginPage()
!!!
%html{:lang=>Yii::$app->language}
    %head
        %meta{:charset=>Yii::$app->charset}
        %meta(name="viewport" content="width=device-width, initial-scale=1")
        !=Html::csrfMetaTags()
        %title =Html::encode($view->title)
        -$view->head()
    %body
        -$view->beginBody()
        !=$content
        -$view->endBody()
-$view->endPage()
```

License
-------

[](#license)

MtHaml extension for Yii2 Framework is released under the MIT license.

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance3

Infrequent updates — may be unmaintained

Popularity22

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~52 days

Total

2

Last Release

4065d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/fbd6c1e93ed92f4ad92b9f53a7bad87eaa598a70bae172a3d40b1333c491b596?d=identicon)[mervick](/maintainers/mervick)

---

Top Contributors

[![mervick](https://avatars.githubusercontent.com/u/2429298?v=4)](https://github.com/mervick "mervick (9 commits)")

---

Tags

twigyii2rendererHAMLmthaml

### Embed Badge

![Health badge](/badges/mervick-yii2-mthaml/health.svg)

```
[![Health](https://phpackages.com/badges/mervick-yii2-mthaml/health.svg)](https://phpackages.com/packages/mervick-yii2-mthaml)
```

###  Alternatives

[craftcms/cms

Craft CMS

3.6k3.6M2.6k](/packages/craftcms-cms)[yiisoft/yii2-twig

The Twig integration for the Yii framework

1431.9M32](/packages/yiisoft-yii2-twig)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)