Twig

灵活、快速且安全的
PHP 模板引擎

a Symfony Product
您正在阅读 Twig 3.x 的文档。切换到 Twig 1.x, 2.x 的文档。

问题与反馈

许可

Twig 文档 基于新的 BSD 许可 授权。

dump

dump 函数转储关于模板变量的信息。这主要用于调试行为不如预期的模板,通过内省其变量

1
{{ dump(user) }}

注意

dump 函数默认情况下不可用。创建 Twig 环境时,您必须显式添加 \Twig\Extension\DebugExtension 扩展

1
2
3
4
5
$twig = new \Twig\Environment($loader, [
    'debug' => true,
    // ...
]);
$twig->addExtension(new \Twig\Extension\DebugExtension());

即使启用,如果环境中的 debug 选项未启用,dump 函数也不会显示任何内容(以避免在生产服务器上泄露调试信息)。

在 HTML 上下文中,用 pre 标签包裹输出,使其更易于阅读

1
2
3
<pre>
    {{ dump(user) }}
</pre>

提示

当启用 XDebughtml_errorson 时,不需要使用 pre 标签;另外,启用 XDebug 后输出也更美观。

您可以通过传递它们作为额外的参数来调试多个变量

1
{{ dump(user, categories) }}

如果您不传递任何值,则会转储当前上下文中的所有变量

1
{{ dump() }}

注意

在内部,Twig 使用 PHP var_dump 函数。

参数

  • context:要转储的上下文