README

为 Twig 提供简单集成包的 Laravel。

警告

LaraTwig 尚未准备就绪，可供公共使用，请自行承担风险！

为什么选择 Twig？

Laravel 内置了 Blade 模板引擎，它是一个轻量级的模板引擎。然而，有时你需要更全面和强大的功能，而 Twig 在 PHP 模板引擎中是当之无愧的领导者。如果你已经熟悉 Twig，那么无需进一步解释... 你已经知道了它的强大。如果你是 Twig 新手，可以查看精彩的文档来了解所有的细节。

为什么选择 LaraTwig？

已经有一个出色的 Twig 包用于 Laravel，并且它的功能比这个包更丰富。我的目标是使用 LaraTwig 提供一个简单直接、易于维护和快速实现的替代方案。

安装和使用

1. 安装

将包添加到您的 composer.json 文件

{
	"require": {
		...
		"kuz/laratwig": "0.*"
	}
}

然后运行 composer update。

2. 集成

在 app/config/app.php 中注册服务提供者

'providers' => array(
	...
	'Kuz\LaraTwig\LaraTwigServiceProvider',
),

3. 配置

如果您想更改默认配置，运行以下 Artisan 命令

php artisan config:publish kuz/laratwig --path=vendor/kuz/laratwig/config

然后您可以在 app/config/packages/kuz/laratwig/twig.php 中进行更改。

4. 创建

在常规位置创建视图文件，使用配置中设置的文件扩展名（默认为 .twig）。

辅助函数

Twig 需要您注册在模板中使用您想要使用的函数。LaraTwig 通过允许您在配置文件中指定它们来简化这一过程。其中已经包含了一些常用的 Laravel 函数，但您可以像这样添加自己的函数

'functions' => [
	...
	'base64_encode',
	'b64e' => function ($value) {
		return base64_encode($value);
	},
],

基本上，我们只是使用了两种不同的方法来向模板添加一个 base64_encode 函数。在第一个例子中，我们告诉 Twig，调用 base64_encode('some string') 将调用同名函数。在第二个例子中，我们告诉 Twig，调用 b64e('my string') 将执行指定的闭包（或您指定的任何其他可调用）。

外观

LaraTwig不提供在您的Twig模板中使用外观的方法。然而，Laravel的app()函数已经为您注册，这应该允许您做几乎所有您通常会做的事情。例如，如果您想在模板中使用Form::text('name')，您将使用app('form').text('name')。

致谢

感谢Fabien Potencier和Twig团队构建了一个惊人的模板引擎。

感谢Taylor Otwell创建并维护了在任何编程语言中最优秀的Web开发框架之一。

感谢Rob Crowe和Barry vd. Heuvel在Laravel TwigBridge包上的工作，这启发了LaraTwig的一些想法。

ku/z / laratwig

维护者

详细信息