Twig

The flexible, fast, and secure
template engine for PHP

a Symfony Product
Docs Installation
You are reading the documentation for Twig 1.x. Switch to the documentation for Twig 2.x, 3.x.
Warning Twig version 1.x is no longer maintained.

Questions & Feedback

License

Twig documentation is licensed under the new BSD license.

Installation

You have multiple ways to install Twig.

Installing the Twig PHP package

Install Composer and run the following command:

1
composer require "twig/twig:^1.0"

Installing the C extension

1.4

The C extension was added in Twig 1.4.

Twig comes with an optional C extension that improves the performance of the Twig runtime engine.

Note that this extension does not replace the PHP code but only provides an optimized version of the \Twig\Template::getAttribute() method; you must still install the regular PHP code

The C extension is only compatible and useful for PHP5.

Install it like any other PHP extensions:

1
2
3
4
5
cd ext/twig
phpize
./configure
make
make install

For Windows:

  1. Setup the build environment following the PHP documentation
  2. Put Twig's C extension source code into C:\php-sdk\phpdev\vcXX\x86\php-source-directory\ext\twig
  3. Use the configure --disable-all --enable-cli --enable-twig=shared command instead of step 14
  4. nmake
  5. Copy the C:\php-sdk\phpdev\vcXX\x86\php-source-directory\Release_TS\php_twig.dll file to your PHP setup.

Tip

For Windows ZendServer, ZTS is not enabled as mentioned in Zend Server FAQ.

You have to use configure --disable-all --disable-zts --enable-cli --enable-twig=shared to be able to build the twig C extension for ZendServer.

The built DLL will be available in C:\\php-sdk\\phpdev\\vcXX\\x86\\php-source-directory\\Release

Finally, enable the extension in your php.ini configuration file:

1
2
extension=twig.so # For Unix systems
extension=php_twig.dll # For Windows systems

And from now on, Twig will automatically compile your templates to take advantage of the C extension.