如何编写一个自定义树枝扩展
编辑本页警告:您正在浏览的文档欧宝官网下载appob娱乐下载Symfony 3.4，现已不再维护。
读本页的更新版本用于Syob娱乐下载mfony 6.2(当前稳定版本)。
如何编写一个自定义树枝扩展
如果你需要创建自定义的Twig函数，过滤器，测试或更多，你将需要创建一个Twig扩展。你可以阅读更多树枝的扩展在Twig文档中。欧宝官网下载app
创建扩展类
假设您想要创建一个名为价格将数字格式化为货币:
1 2 3 4
{{产品。价格|price }}{#传入3个可选参数#}{{产品。价格|price(2, ',', '.') }}创建一个可扩展的类AbstractExtension然后填入逻辑:
12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23
/ / src / AppBundle /理解/ AppExtension.php名称空间AppBundle＼嫩枝；使用嫩枝＼扩展＼AbstractExtension；使用嫩枝＼TwigFilter；类AppExtension扩展AbstractExtension｛公共函数getFilters（）｛返回［新TwigFilter (“价格”, (＄这，“formatPrice”)));｝公共函数formatPrice（＄数量，＄小数＝0，＄decPoint＝“。”，＄thousandsSep＝”、“）｛＄价格= number_format (＄数量，＄小数，＄decPoint，＄thousandsSep）;＄价格＝“美元”．＄价格；返回＄价格；}}请注意
在Twig 1.26之前，你的扩展必须定义一个额外的getName ()方法，该方法返回带有扩展的内部名称的字符串(例如。app.my_extension)．当你的扩展需要兼容1.26之前的Twig版本时，包括上面例子中省略的这个方法。
下面是如何创建一个自定义函数：
12 3 4 5 6 7 8 9 10 11 12 13 14 16 17 18 19 20
/ / src / AppBundle /理解/ AppExtension.php名称空间AppBundle＼嫩枝；使用嫩枝＼扩展＼AbstractExtension；使用嫩枝＼TwigFunction；类AppExtension扩展AbstractExtension｛公共函数getFunctions（）｛返回［新TwigFunction (“区域”, (＄这，“calculateArea”)));｝公共函数calculateArea(int＄宽度, int＄长度）｛返回＄宽度＊＄长度；}}提示
除了自定义过滤器和函数，您还可以注册全局变量．
将扩展注册为服务
接下来，将类注册为服务并标记为twig.extension．如果你在用默认的服务。yml配置，你完蛋了!ob娱乐下载Symfony将自动了解您的新服务并添加标记。
你现在可以开始在任何Twig模板中使用你的过滤器。
创建惰性加载的树枝扩展
1.35
在Twig 1.35.0和2.4.4中引入了对惰性加载扩展的支持。
在Twig扩展类中包含自定义过滤器/函数的代码是创建扩展的最简单方法。然而，在呈现任何模板之前，Twig必须初始化所有扩展，即使模板没有使用扩展。
如果扩展没有定义依赖关系(也就是说，如果你没有在扩展中注入服务)，性能不会受到影响。然而，如果扩展定义了大量复杂的依赖关系(例如那些建立数据库连接的依赖关系)，性能损失可能是显著的。
这就是为什么Twig允许将扩展定义与其实现解耦的原因。与前面的示例相同，第一个更改是删除formatPrice ()中定义的PHP可调用对象getFilters ()：
12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
/ / src / AppBundle /理解/ AppExtension.php名称空间AppBundle＼嫩枝；使用AppBundle＼嫩枝＼AppRuntime；使用嫩枝＼扩展＼AbstractExtension；使用嫩枝＼TwigFilter；类AppExtension扩展AbstractExtension｛公共函数getFilters（）｛返回［//这个过滤器的逻辑现在在一个不同的类中实现新TwigFilter (“价格”, (AppRuntime：：类,“formatPrice”)));}}然后，创建新的AppRuntime类(这不是必需的，但这些类的后缀是运行时按照惯例)，并包括前面的逻辑formatPrice ()方法:
12 3 4 5 6 7 8 9 10 11 12 13 14 16 17 18 19 20 21
/ / src / AppBundle /理解/ AppRuntime.php名称空间AppBundle＼嫩枝；使用嫩枝＼扩展＼RuntimeExtensionInterface；类AppRuntime实现了RuntimeExtensionInterface｛公共函数__construct（）｛//这个简单的例子没有定义任何依赖项，但是在你自己的依赖项中//扩展，你需要使用这个构造函数注入服务｝公共函数formatPrice（＄数量，＄小数＝0，＄decPoint＝“。”，＄thousandsSep＝”、“）｛＄价格= number_format (＄数量，＄小数，＄decPoint，＄thousandsSep）;＄价格＝“美元”．＄价格；返回＄价格；}}3.4
的RuntimeExtensionInterface在Symfony 3.4中引入。ob娱乐下载
如果您使用默认设置services.yaml配置，这将已经工作!否则,创建服务对于这门课来说标记你的服务与twig.runtime．
