buzzingpixel/corbomite-twig

1.2.1 2019-10-24 23:41 UTC

README

BuzzingPixel 的 Corbomite 项目的组成部分。

提供对 Twig 的非常轻量级的包装。

用法

APP_BASE_PATH

如果您想明确设置它,则可以定义 APP_BASE_PATH 常量。否则,Corbomite Twig 将自动解决它。

使用 Corbomite Dependency Injector 获取 Twig 环境实例。

<?php
declare(strict_types=1);

use corbomite\di\Di;
use corbomite\twig\TwigEnvironment;

$twig = Di::get(TwigEnvironment::class);

开发模式

Corbomite Twig 寻找一个名为 DEV_MODE 的环境变量。如果设置为字符串 'true',则 Twig 将设置为启用调试,并且严格变量将设置为 true。此外,还将添加 Twig 的 Debug Extension,该扩展将 {{ dump(var) }} 函数添加到 Twig 中。

缓存路径

您可以使用一个名为 TWIG_CACHE_PATH 的环境变量,并使用一个字符串指定 Twig 用于其缓存的绝对路径。如果您没有指定缓存路径,它将默认为 APP_BASE_PATH . '/cache'

全局变量

您或任何 composer 包可以指定要添加到 Twig 的全局数组,通过在 composer.json 的 extra 对象中设置键 twigGlobalsFilePath。在该文件中指定的文件应返回一个 key => value 全局变量的数组。

Twig 扩展

您或任何 composer 包可以指定一个数组,其中包含要加载的 Twig 扩展类,通过在 composer.json 的 extra 对象中将键 twigExtensions 设置为数组,其中包含完全限定的类名。这些类将从 Corbomite DI 或新建(如果尚未添加到 DI 配置)中检索。

Twig 模板目录

您或任何 composer 包可以指定一个数组,其中包含 Twig 环境的模板目录,通过在 composer.json 中设置键 twigTemplatesDirectories,该对象中的键是命名空间,值是模板目录的绝对路径。如果键为空,则认为是根/主要模板目录。Composer 包不应有空键,只有应用程序/项目应如此。

许可证

版权所有 2019 BuzzingPixel, LLC

根据 Apache License, Version 2.0(“许可证”)许可;除非您遵守许可证规定,否则不得使用此文件。您可以在 https://apache.ac.cn/licenses/LICENSE-2.0 获取许可证副本。

除非适用法律要求或书面同意,否则在许可证下分发的软件按“原样”分发,不提供任何明示或暗示的保证或条件。请参阅许可证了解特定语言管理许可和限制的内容。