Found a typo or an error?
Open a ticket.
Need support or have a technical question?
Post to the user mailing-list.
Twig documentation is licensed under a
Creative Commons Attribution-Share Alike 3.0
Unported License.
This is the documentation for Twig, the flexible, fast, and secure template engine for PHP.
If you have any exposure to other text-based template languages, such as Smarty, Django, or Jinja, you should feel right at home with Twig. It's both designer and developer friendly by sticking to PHP's principles and adding functionality useful for templating environments.
The key-features are...
Twig needs at least PHP 5.2.4 to run.
You have multiple ways to install Twig. If you are unsure what to do, go with the tarball.
git clone git://github.com/fabpot/Twig.gitsvn co http://svn.twig-project.org/trunk/ twigpear channel-discover pear.twig-project.orgpear install twig/Twig (or pear install twig/Twig-beta)curl -s http://getcomposer.org/installer | php
composer.json file in your project root:{
"require": {
"twig/twig": "1.6.0"
}
}
php composer.phar install
New in version 1.4: The C extension was added in Twig 1.4.
Twig comes with a C extension that enhances the performance of the Twig runtime engine. You can install it like any other PHP extension:
$ cd ext/twig
$ phpize
$ ./configure
$ make
$ make install
Finally, enable the extension in your php.ini configuration file:
extension=twig.so
And from now on, Twig will automatically compile your templates to take
advantage of the C extension. Note that this extension does not replace the
PHP code but only provides an optimized version of the
Twig_Template::getAttribute() method.
Tip
On Windows, you can also simply download and install a pre-build DLL.
This section gives you a brief introduction to the PHP API for Twig.
The first step to use Twig is to register its autoloader:
require_once '/path/to/lib/Twig/Autoloader.php';
Twig_Autoloader::register();
Replace the /path/to/lib/ path with the path you used for Twig
installation.
Note
Twig follows the PEAR convention names for its classes, which means you can easily integrate Twig classes loading in your own autoloader.
$loader = new Twig_Loader_String();
$twig = new Twig_Environment($loader);
echo $twig->render('Hello {{ name }}!', array('name' => 'Fabien'));
Twig uses a loader (Twig_Loader_String) to locate templates, and an
environment (Twig_Environment) to store the configuration.
The render() method loads the template passed as a first argument and
renders it with the variables passed as a second argument.
As templates are generally stored on the filesystem, Twig also comes with a filesystem loader:
$loader = new Twig_Loader_Filesystem('/path/to/templates');
$twig = new Twig_Environment($loader, array(
'cache' => '/path/to/compilation_cache',
));
echo $twig->render('index.html', array('name' => 'Fabien'));
