新闻详情

新闻详情

首页 / 资讯中心 / 详情

Twig keys 过滤器详解:从模板语法到 CoreExtension 源码实现

发布时间:2026/11/16 20:23:14来源:尧图网络
Twig keys 过滤器详解:从模板语法到 CoreExtension 源码实现
后端【免费下载链接】TwigTwig, the flexible, fast, and secure template language for PHP项目地址https://gitcode.com/gh_mirrors/tw/Twig点击查看免费下载本篇指南围绕 Twig 模板语言中的keys过滤器展开它如何从序列sequence或映射mapping中提取全部键、在{% for %}循环和表达式链中的典型用法以及CoreExtension::keys()内部如何区分数组、可遍历对象和其他输入类型。读完后你将掌握keys的完整行为边界包括null、Traversable对象等特殊情况并能理解其底层实现与测试证据从而在模板开发中放心地对任意可迭代数据做键值操作。一、keys 过滤器的基本用法keys过滤器返回一个序列或映射的所有键。最典型的场景是当你只需要遍历键、而不需要键对应的值时{% for key in [a, b, c, d]|keys %} {{ key }} {% endfor %} {# outputs: 0 1 2 3 #} {% for key in {a: a_value, b: b_value}|keys %} {{ key }} {% endfor %} {# outputs: a b #}两个示例覆盖了 PHP 数组的两种形态序列[a, b, c, d]是一个数字索引的列表keys提取出0 1 2 3映射{a: a_value, b: b_value}是字符串键的关联数组keys提取出a b。官方文档特别指出Twig 内部使用 PHP 的array_keys函数见 doc/filters/keys.rst。这句话点明了数组分支的实现方式但真实源码中的行为比array_keys一行代码要丰富得多——因为 Twig 还要处理可遍历对象这一类输入。二、源码实现CoreExtension::keys() 的三条分支keys过滤器在核心扩展中注册注册点位于 CoreExtension.phpnew TwigFilter(keys, [self::class, keys]),实际实现是CoreExtension的静态方法keys()位于 CoreExtension.php。完整逻辑如下public static function keys($array): array { if ($array instanceof \Traversable) { while ($array instanceof \IteratorAggregate) { $array $array-getIterator(); } $keys []; if ($array instanceof \Iterator) { $array-rewind(); while ($array-valid()) { $keys[] $array-key(); $array-next(); } return $keys; } foreach ($array as $key $item) { $keys[] $key; } return $keys; } if (!\is_array($array)) { return []; } return array_keys($array); }从源码结构看该方法按输入类型分成三条处理路径Traversable分支如果输入实现了\Traversable先用while循环不断调用getIterator()剥掉IteratorAggregate的外壳这样可以支持层层包装聚合迭代器的对象直到拿到真正的\Iterator为止随后调用rewind()从头遍历通过key()逐个收集键。若最终对象并非原生Iterator则退化为foreach收集键。非数组分支既不是可遍历对象、又不是数组例如null直接返回空数组[]。数组分支直接调用 PHP 内建的array_keys()这与文档描述一致。这种分层设计解释了为什么keys不仅能处理模板里书写的字面量数组还能处理传入模板上下文的迭代器对象。三、边界行为null、Traversable 与 SimpleXMLElement单元测试 CoreTest.php 中的testArrayKeysFilter方法通过provideArrayKeyCases数据提供了官方认可的边界行为清单public static function provideArrayKeyCases() { $array [a a1, b b1, c c1]; $keys array_keys($array); return [ [$keys, $array], [$keys, new CoreTestIterator($array, $keys)], [$keys, new CoreTestIteratorAggregate($array, $keys)], [$keys, new CoreTestIteratorAggregateAggregate($array, $keys)], [[], null], [[a], new \SimpleXMLElement(xmla/a/xml)], ]; }由此可以确认几条关键事实普通数组返回与array_keys()一致的结果Iterator/IteratorAggregate/ 双层包装的IteratorAggregateAggregate都能正确提取出全部键验证了源码中getIterator()剥壳逻辑的有效性null输入返回空数组[]模板中null|keys不会报错而是得到空列表SimpleXMLElementnew \SimpleXMLElement(xmla/a/xml)的键是[a]说明 XML 元素对象同样可以通过该过滤器提取属性名。四、与 for 标签的配合实际测试用例集成测试夹具 tags/for/keys.test 演示了文档示例对应的完整运行结果{% for key in items|keys %} * {{ key }} {% endfor %}配合数据[items [a, b]]预期输出为* 0和* 1。另一个夹具 tags/for/objects.test 展示了keys在迭代器对象上的表现模板先以{% for key, value in items %}遍历一个实现了\Iterator的ItemsIterator对象再以{% for key in items|keys %}单独提取键期望输出为* foo和* bar——即迭代器内部数组的字符串键。此外keys在表达式链中也经常作为中间环节出现例如 filters/merge.test 用items|merge({bar: foo})|keys|join校验合并后的键集合filters/slice.test 用[1, 2, 3, 4]|slice(1, 2)|keys|join()验证切片后键是否保留。这说明keys是构建复杂表达式管道的常用构件。五、沙箱模式与旧版内部函数的兼容性说明在沙箱sandbox环境下keys同样受到白名单管控。SandboxTest.php 中存在形如{{ arr|keys|join(,) }}的用例其中keys被列入允许的过滤器列表[column, first, keys]表明在Sandbox开启时只有显式放行的过滤器才能被模板调用keys属于核心过滤器之一。对于从旧版 Twig 迁移的读者还有一个兼容性细节历史上编译产物会调用内部函数twig_get_array_keys_filter()该函数保留在 src/Resources/core.php 中并自 Twig 3.9 起被标记为deprecated内部只是转发到CoreExtension::keys($array)并触发废弃提示。因此在当前仓库版本中应当以CoreExtension::keys()为准来理解该过滤器的行为遗留函数仅服务于向后兼容。六、小结何时使用 keys只需要键而不需要值时items|keys配合{% for %}是最直接的写法需要在表达式中对键做join、first、length等后续操作时keys是提取键集的标准入口输入为null时得到空数组而非错误可以放心用于可能缺失的上下文变量传入迭代器含多层IteratorAggregate包装时实现层会自动解包并提取键行为与数组一致。相关路径索引官方文档 doc/filters/keys.rst、过滤器实现 src/Extension/CoreExtension.php、单元测试 tests/Extension/CoreTest.php、集成夹具 tests/Fixtures/tags/for/keys.test 与 tests/Fixtures/tags/for/objects.test。赞分享后端【免费下载链接】TwigTwig, the flexible, fast, and secure template language for PHP项目地址https://gitcode.com/gh_mirrors/tw/Twig点击查看免费下载相关推荐Twig IntlExtension 深度解析currency_symbol 过滤器从用法到源码实现Twig IntlExtension 深度解析currency_symbol 过滤器从用法到源码实现 currency_symbol 是 Twig 官方 In后端Twig column 过滤器详解从一行模板语法到 PHP array_column 与沙箱安全检查Twig column 过滤器详解从一行模板语法到 PHP array_column 与沙箱安全检查 column 是 Twig 核心过滤器之一用于从一个对后端Twig convert_encoding 过滤器基于 iconv 的模板层字符编码转换详解Twig convert_encoding 过滤器基于 iconv 的模板层字符编码转换详解 在涉及多语言数据源如日文、俄文、中文内容混排的 PHP 项目后端上一篇Davinci大数据可视化终极性能优化指南10个技巧让海量数据流畅展示下一篇数学问题解决数据集从学术研究到产业应用的全流程指南创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

【外设】之大彩串口显示屏 2026/11/15 4:54:16

【外设】之大彩串口显示屏

大彩串口屏初步使用 1 .官网下载 STM32 屏幕 GUI 设计资料 http://www.gz-dc.com/category/typeid/4112 找到 STM32 Keil 工程,移植相关代码因项目而异进行移植,由于项目简单,本人只对用到的指令接口进行修改。 比如:注意事项&…

阅读更多 →
无法下载Windows系统iso文件 2026/11/15 2:04:12

无法下载Windows系统iso文件

当我遇到这个问题的时候,我打开了一个网站: 登录 然后我打算下载的时候: 突然那个官方的连接就可以下载了:

阅读更多 →
【清华代码熊】DeepSeek V4.1 Flash 后训练详解 2026/11/16 19:23:38

【清华代码熊】DeepSeek V4.1 Flash 后训练详解

📌 上期解析了 DeepSeek V4.1 Flash 模型架构改进,本期解析 DeepSeek V4.1 Flash 预训练/后训练技术: 🌟 预训练:45T 文本 多模态混合语料、直接训练 sparse attention(取消 DeepSeek V4 的 dense 冷启动&…

阅读更多 →
Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ... 2026/11/16 6:47:19

Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ...

文章主要内容和创新点 主要内容 本文聚焦于多模态大语言模型(MLLM)强化学习(RL)训练中的效率问题,提出了一个名为Shuffle-R1的框架。研究发现,当前RL训练存在两个关键缺陷: 优势值坍缩(Advantage Collapsing):批次中大多数优势值集中在零附近,导致有效梯度信号被淹…

阅读更多 →
PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction 2026/11/14 16:35:50

PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction

一、文章主要内容总结 本文聚焦于利用大型语言模型(LLMs)实现个人身份信息(PII)脱敏的研究,旨在解决传统脱敏方法(如基于规则的系统、领域特定命名实体识别(NER)模型)泛化能力差、跨格式/跨语境适应性弱的问题。 研究通过全面评估多种LLM架构(包括密集型LLM(D-LLM…

阅读更多 →
LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model 2026/11/16 17:28:18

LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model

文章主要内容和创新点 主要内容 本文聚焦于二进制图像-文本相关性评估任务(判断图像与文本“相关”或“不相关”),针对该任务中文本格式多样、相关性定义随场景变化等挑战,提出了基于多模态大语言模型(MLLM)的解决方案LLaVA-RE。 模型设计:LLaVA-RE基于LLaVA 1.5架构,…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉