r1pp3rj4ck / twigstringbundle
Renders strings instead of files with Twig
Installs: 14 853
Dependents: 1
Suggesters: 0
Security: 0
Stars: 3
Watchers: 2
Forks: 18
Type:symfony-bundle
Requires
- php: >=5.3.2
- symfony/framework-bundle: 2.*
- symfony/security-bundle: 2.*
- twig/twig: 1.*
This package is not auto-updated.
Last update: 2024-11-15 15:37:12 UTC
README
This Symfony2 Bundle adds the possibility to render strings instead of files with the Symfony2 native Twig templating engine.
The Bundle adds an additional service named twigstring
. It is used the same way as the original templating service.
The only difference is that the first argument of the method render(<string>, [<array])
is a string to parse instead of a template file.
The bundles supports variable output, conditions, loops and rendering of an controller. It does NOT support including templates, yet. It would interpret the template name as twigstring.
One example usage scenario is to load templates from the database instead of using files.
Extension ideas:
- option to include templates
- add a black-/whitelist for allowed allowed twig tags
Installation
If you are an advanced Symfony developer, you know how things are done. The package's name is r1pp3rj4ck/TwigstringBundle
and you need the dev-master
version of it, and the bundle's FQN is LK\TwigstringBundle\LKTwigstringBundle()
. You also need a top-level entry to your config: lk_twigstring: ~
.
Of course, if you're not sure about yourself, here is the step-by-step installation procedure:
1. Register the bundle in composer
You need to add it to your composer.json requirements:
{ "require": { "r1pp3rj4ck/TwigstringBundle": "dev-master" } }
2. Downloading the bundle from packagist
Install it by running the following command:
$ ./composer.phar update r1pp3rj4ck/TwigstringBundle
3. Registering the bundle in the kernel
<?php // app/AppKernel.php public function registerBundles() { $bundles = array( // ... new LK\TwigstringBundle\LKTwigstringBundle(), // ... ); }
4. Registering the bundle in the configuration
# app/config/config.yml lk_twigstring: ~
Usage
// set example parameter $vars = array('var'=>'x'); // get twigstring service $tpl_engine = $this->get('twigstring'); // render example string $vars['test'] = 'u ' . $tpl_engine->render('v {{ var }} {% if var is defined %} y {% endif %} z{% for i in 1..5 %} {{ i }}{% endfor %}', $vars);
or use the short way:
// set example parameter $vars = array('var'=>'x'); // render example string $vars['test'] = 'u ' . $this->get('twigstring')->render('v {{ var }} {% if var is defined %} y {% endif %} z{% for i in 1..5 %} {{ i }}{% endfor %}', $vars);
Example output:
u v x y z
License
The bundle is licensed under MIT license. For full license see LICENSE file
Authors
LarsK (Lars Krüger), cordoval (Luis Cordova), r1pp3rj4ck (Attila Bukor)