README

此TYPO3扩展允许您在TYPO3项目中使用出色的Twig模板引擎。

您可以在Extbase控制器或TypoScript中使用Twig模板。

版本兼容性

以下表格显示了此软件包的哪些版本与哪些TYPO3版本兼容。

版本1与TYPO3 8.7 和 9.5 兼容。
版本2与TYPO3 10.4 和 11.5 兼容。
在master分支上开发的版本3仅与TYPO3 v12兼容

从版本2开始，需要PHP 7.4。

安装

此扩展仅在安装为composer模式时才有效。如果您不熟悉使用composer与TYPO3一起使用，您可以在TYPO3网站上找到如何操作的说明。

使用以下命令安装扩展

composer require cvc/typo3-twig

入门

Twig模板的渲染几乎与Fluid模板的渲染方式完全相同。

与Fluid不同，在Twig中没有“布局”或“部分”。一切只是模板。因此，缺少了一些您可能习惯在Fluid中使用的功能。

在TypoScript中渲染模板

要渲染一个Twig模板，您可以使用TWIGTEMPLATE内容对象。您可以使用它的方式与Fluid在之前使用的方式类似。变量作为内容对象渲染，并且可以进行数据处理。

page = PAGE
page.10 = TWIGTEMPLATE
page.10 {
    templateName = example.html.twig
    variables {
        foo = TEXT
        foo.value = Bar!
    }
    templateRootPaths {
        10 = EXT:cvc_twig/Resources/Private/TwigTemplates
    }
    dataProcessing {
        10 = TYPO3\CMS\Frontend\DataProcessing\FilesProcessor
        10 {
            references.fieldName = image
        }
    }
}

文档

完整文档可在此处查看：cvc_twig 文档。

替代方案

此扩展并不是第一个支持渲染Twig模板的扩展。我们决定创建自己的扩展，因为其他扩展要么不再维护，要么带有过多的开销，或者它们没有与Fluid参考实现紧密开发。

以下表格中您可以找到提供Twig模板引擎集成功能的其他扩展

cvc / typo3-twig

维护者

详细信息

README

版本兼容性

安装

入门

在TypoScript中渲染模板

文档

替代方案