twig中{% for %}的基本写法是{% for item in items %}...{% endfor %},支持空数组/undefined自动跳过、键值对遍历、loop内置变量(如loop.index、loop.first)、数字范围(0..9)、条件过滤及嵌套循环,需确保数据源为数组或traversable。

Twig 中 {% for %} 的基本写法
直接用 {% for item in items %},不是 PHP 那套 foreach ($items as $item)。Twig 的语法更接近自然语言,但大小写和空格必须严格匹配。
常见错误是漏掉 endfor 或写成 endforeach(那是 PHP);也有人把变量名写错,比如 {% for user in users %} 却传了 $data['users'] 而不是 $data['users'] —— Twig 里只认键名,不认 PHP 变量名。
{% for post in posts %}{{ post.title }}{% endfor %}- 如果
posts是空数组或null,循环自动跳过,不会报错 - 支持嵌套:
{% for user in users %}{% for post in user.posts %}...{% endfor %}{% endfor %}
怎么安全遍历可能为 null 或非数组的数据
Twig 默认对 null、false、未定义变量静默处理,但遇到字符串或整数时会报 Impossible to iterate a scalar value 错误 —— 这是最常卡住新手的地方。
别依赖模板层做类型判断,后端应确保传入的是数组或 Traversable。实在要兜底,用 default 过滤器:
-
{% for item in items|default([]) %}:强制转为空数组 -
{% for item in items ?? [] %}:等价写法,更简洁 - 避免
{% if items is defined %}{% for ... %}{% endif %},多一层判断没实际意义
常用内置变量:loop.index、loop.first 怎么用
Twig 在 {% for %} 内自动提供 loop 对象,不用额外传参。注意命名全小写,loop.Index 或 loop.first() 都无效。
-
loop.index:从 1 开始的当前索引(第几个元素) -
loop.index0:从 0 开始,适合做数组下标或 CSS 类名 -
loop.first/loop.last:布尔值,判断是否首/末项 -
loop.length:总数量,但别在循环内反复用它做性能敏感操作
示例:{% for post in posts %}<div class="post {{ loop.first ? 'first' : '' }}">...</div>{% endfor %}
Symfony 场景下容易被忽略的点
在 Symfony 控制器中传数据给 Twig 时,别用 array_values() 强制重排索引 —— 如果原始数组是关联的(比如 ['a' => ..., 'b' => ...]),array_values() 会丢掉键名,但多数时候你并不需要它;反而可能破坏前端 JS 依赖的 key 绑定。
另外,Doctrine 查询结果默认是对象数组,{% for user in users %}{{ user.name }}{% endfor %} 没问题,但别试图在模板里调用 user.getName() —— Twig 默认只访问 public 属性或通过 getter(需启用 autoescape 和 property_accessor 配置),稳妥做法是控制器提前映射好字段。
真正麻烦的是分页场景:别在模板里写 {% for post in pagination.items %} 然后又手动算偏移量,直接用 KnpPaginatorBundle 提供的 pagination 对象和 pagination.items 即可 —— 它已经处理好了切片。











