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.

Questions & Feedback


Twig documentation is licensed under the new BSD license.


You have multiple ways to install Twig.

Installing the Twig PHP package

Install Composer and run the following command:

composer require "twig/twig:^1.0"

Installing the C extension

New in version 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:

cd ext/twig
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.


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:

2 # 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.

Website powered by Symfony and Twig, deployed on
The Twig logo is © 2010-2021 Symfony