nicedump/nicedump-twig

NiceDump 格式变量导出扩展

v2.0.0 2022-09-29 15:52 UTC

This package is auto-updated.

Last update: 2024-09-29 04:25:40 UTC


README

Tests StyleCI License Latest Stable Version Total Downloads

Twig 扩展,用于根据NiceDump 格式规范导出变量。

需求

  • PHP >= 8.0

使用 composer 安装

$ composer require nicedump/nicedump-twig

基本用法

启用此扩展后,可以在 Twig 模板中使用 nice_dump() 函数以 NiceDump 格式输出变量。

只有当 Twig 中启用调试模式时,才会输出变量,否则 nice_dump() 返回空字符串。这使得函数可以在开发和生产模式下都使用。

导出变量

{{ nice_dump(foo) }}

输出可能如下所示

<!--
=====BEGIN NICE-DUMP=====
eyJ0eXBlIjoic3RyaW5nIiwidmFsdWUiOiJGb28iLCJzaXplIjozfQ==
=====END NICE-DUMP=====
-->

注意,NiceDump 被包含在 HTML 注释中。

带有名称的变量导出

{{ nice_dump(foo, 'Foo') }}

带有名称和注释的变量导出

{{ nice_dump(foo, 'Foo', 'This is my Foo') }}

在发布模式下启用输出

注意:这可能会意外地在生产服务器上泄露机密数据。请谨慎使用!

启用 nice_dump() 以在非调试模式下输出 NiceDump

use NiceDumpTwig\NiceDumpTwigExtension;

$extension = new NiceDumpTwigExtension();
$extension->enableInReleaseMode();

许可证

MIT