README

版本 1.0.1

Kohana-twig 是一个为流行的 Kohana 3.3 模块，用于 Twig 模板引擎。它被设计为在 Kohana 框架的指南和最佳实践中提供 Twig 的全部功能。该模块提供了一种使用 Twigs 的方式，就像使用 Kohana 视图 一样，并且使用自定义的 Twig Loader 在 级联文件系统 中定位 Twig 模板文件。

寻找 Koseven 模块吗？

看看 koseven-twig，由 errotan 提供。

安装

首先，将包添加到 composer.json 的需求中

"tommcdo/twig"  : "1.0.*"

然后，使用 composer php composer.phar update 进行安装

然后，在 APPPATH/bootstrap.php 中通过将其添加到模块初始化中启用该模块

Kohana::modules(array(
	// ... all your other modules ...
	'twig'       => MODPATH.'kohana-twig',       // Twig templating engine
));

此模块是为 Kohana 3.3 设计的，但可以通过将 classes/ 目录中的所有文件名更改为小写，轻松地使其与 Kohana 3.2 一起工作。

使用方法

就像使用 Kohana 视图一样使用 Twigs。默认情况下，您的 Twig 文件位于级联文件系统中的任何位置的 twigs 目录中，并具有 .html 扩展名。（这两个设置都可以进行配置。）例如，假设您有一个位于 APPPATH/twigs/main.html 的 Twig 文件，内容如下

<p>Hello, {{ name }}</p>

在您的操作中，您将按照以下方式附加 Twig

$twig = Twig::factory('main');
$twig->name = 'Tom';
$this->response->body($twig);

您的 Twig 文件还可以通过名称引用其他模板，这些模板将使用级联文件系统进行定位。请注意，省略了 twig 文件的扩展名；在以下 Twig 模板示例中，名为 template.html 的文件将位于级联文件系统中

{% extends "template" %}

有关 Twig 模板的更多信息，请参阅 Twig for Template Designers

配置

默认配置存储在 MODPATH/twig/config/twig.php 中。要覆盖它，您可以在 APPPATH/config/twig.php（或在此之前加载的任何模块的 config/ 目录中）创建一个配置文件，该文件指定您想要更改的任何选项的值。

扩展

Twig 提供了许多扩展基本模板环境的方式。在 kohana-twig 中，可以通过覆盖静态 Twig::env() 方法来实现。要这样做，您可以定义位于 APPPATH/classes/Twig.php 的类如下

class Twig extends Kohana_Twig {

	protected static function env()
	{
		// Instantiate the base Twig environment from parent class.
		$env = parent::env();

		// Customize as needed.
		$env->addExtension(new Twig_Extension_Example);
		// ... do more stuff if you'd like ...

		return $env;
	}

} // End Twig

贡献

贡献总是受欢迎和赞赏的。由于这是一个 Kohana 模块，我主要要求代码符合 Kohana 的约定和样式。如果您不熟悉它们，请仔细阅读。