README

TwigModify is a twig tag that can modifies everythink you want eg. cssmin, jsmin and more.

Installing

Installing via composer is recommended.

"require": {
 "phpmob/twig-modify-bundle": "~2.0"
}

Enabling

And then enable bundle in AppKernel.php

public function registerBundles()
{
 $bundles = [
 ...
 new \PhpMob\TwigModifyBundle\PhpMobTwigModifyBundle(),
 ];
}

Usage

In order to modify your twig is simple just wrap {% modify modifier %}...{% modify %} like this:

{% modify jsmin %}
 <script type="text/javascript">
 $(function() {
 ....
 });
 </script>
{% endmodify %}

That was it!

Build-in Modifiers

There are supported modifiers in this bundle.

JSMin

A wrapped modifier for \JShrink\Minifier::minify, Thanks tedivm/jshrink

{% modify jsmin %}
 <script type="text/javascript">
 $(function() {
 ....
 });
 </script>
{% endmodify %}

CSSMin

A wrapped modifier for \tubalmartin\CssMin\Minifier::minify, Thanks tubalmartin/cssmin

{% modify cssmin %}
 <style type="text/css">
 body {
 color: red;
 }
 </style>
{% endmodify %}

HtmlPurify

A wrapped modifier for \HTMLPurifier::purify, Thanks ezyang/htmlpurifier

{% modify htmlpurify %}
 <SCRIPT »
 SRC=http://ha.ckers.org/xss. »
 js></SCRIPT>
{% endmodify %}

AntiXss

A wrapped modifier for \voku\helper\AntiXSS, Thanks voku/anti-xss

{% modify antixss %}
 {{ harm_string|raw }}
{% endmodify %}

Cache

TwigModifyBundle use local cache folder by default, however you can use any cache that implemented \Symfony\Component\Cache\Adapter\AdapterInterface interface and then change the confiuration for your cache service:

phpmob_twig_modify:
 cache_adapter: "my_cache_adapter_service_id"

You can also use symfony framework-bundle cache adapter.

phpmob_twig_modify:
 cache_adapter: "cache.app"

Don't fogot enable DoctrineCacheBundle in your AppKernel.php - See https://symfony.com/doc/current/bundles/DoctrineCacheBundle/index.html

Your own modifiers

You can add/override modifiers by easy configuration:

phpmob_twig_modify:
 modifiers:
 xss: # a modifier name
 enabled: true # default true, toggle enable/disable this modifier.
 class: \PhpMob\TwigModifyBundle\Modifier\HTMLPurify # static class or any service
 method: purify # service method that's allowed to accept `[$content, (array) $options]
 options: # are array options you want to past into your modifier method - `\PhpMob\TwigModifyBundle\Modifier\HTMLPurify::purify` in this case.
 Cache.SerializerPath: "%kernel.cache_dir%/htmlpurify"

After that you already to use your new modifier.

 {% modify xss %}
 <SCRIPT »
 SRC=http://ha.ckers.org/xss. »
 js></SCRIPT>
 {% endmodify %}

Configuration

Configuration reference:

phpmob_twig_modify:
 # cache adapter serivce implemented `\Symfony\Component\Cache\Adapter\AdapterInterface` interface.
 cache_adapter: "my_cache_service_id"
 # application wide toggle enable/disable all modifiers
 enabled: true
 # custom/override modifiers (same key of modifier will override other previous defined)
 modifiers:
 name:
 class: ModifierClassOrService
 method: ModifierMethod
 options: ArrayOfSecondModifierMethod
 enabled: ToggleDisableEnable

Thanks

- https://github.com/nibsirahsieu/SalvaJshrinkBundle to nice demonstration.
- https://github.com/Exercise/HTMLPurifierBundle to nice demonstration.
- https://github.com/ezyang/htmlpurifier
- https://github.com/tubalmartin/YUI-CSS-compressor-PHP-port
- https://github.com/tedious/JShrink
- https://github.com/voku/anti-xss

License

MIT