php twig中文手册,介绍 · Twig 中文文档 · 看云

# 介绍

这是Twig模板引擎的文档。Twig是一款灵活、快速、安全的PHP模板引擎。

如果你接触过其他基于文本的模板语言，比如 Smarty、Django、或者Jinja，你便能轻松掌握Twig。它坚持PHP的原则，并为模板环境添加了有用的功能，使其同时保持对设计师和开发者友好。

Twig拥有以下关键特性：

-

快速：Twig将模板编译为纯粹的，最优化的PHP代码。它的开销与常规的PHP代码相比，已经降到了极低。

-

安全：Twig拥有沙盒模式，用于评估未受信任的模板代码。这使得Twig可以用于允许用户自行修改模板设计的应用程序中。

-

灵活：Twig由一个灵活的词法分析器和解析器驱动。这使得开发者可以自定义标签和过滤器，并创建自己的DSL。

Twig已被用于许多开源项目，比如Symfony, Drupal8, eZPublish,phpBB, Piwik, OroCRM；并且许多框架也支持它，例如Slim, Yii, Laravel, Codeigniter and Kohana — 就举这几个例子好了，有点多。

### 先决条件

Twig只要需要**PHP 5.2.7**才能运行。

### 安装

建议通过Composer来安装Twig：

~~~

composer require "twig/twig:~1.0"

~~~

> 要想了解更多其他安装方法，请阅读安装文档，它还解释了如何安装Twig C扩展。

### 基础的API用法

本节为你简要介绍Twig的PHP API。

~~~

require_once '/path/to/vendor/autoload.php';

$loader = new Twig_Loader_Array(array(

'index' => 'Hello {{ name }}!',

));

$twig = new Twig_Environment($loader);

echo $twig->render('index', array('name' => 'Fabien'));

~~~

Twig使用一个加载器loader(`Twig_Loader_Array`)来定位模板，以及一个环境变量environment(`Twig_Environment`)来存储配置信息。

其中， `render()` 方法通过其第一个参数载入模板，并通过第二个参数中的变量来渲染模板。

由于模板通常是存放在文件系统中的，Twig还有一个文件系统加载器：

~~~

$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'));

~~~

注意：

> 如果你没有使用Composer，像下面这样使用Twig的内置自动加载器：

~~~

require_once '/path/to/lib/Twig/Autoloader.php';

Twig_Autoloader::register();

~~~