mildlygeeky / craft-kint
为 Craft CMS 3.x 添加 Kint,一个内联 PHP 调试器,用于 Twig 和 PHP。
Requires
- craftcms/cms: ^3.0.0-RC1
- kint-php/kint: ^3.1
- kint-php/kint-js: ^2.0
- kint-php/kint-twig: ^2.0
This package is auto-updated.
Last update: 2022-07-25 19:25:21 UTC
README
为 Craft CMS 3.x 添加 Kint,一个内联 PHP 调试器,用于 Twig 和 PHP。
要求
此插件需要 Craft CMS 3.0 或更高版本。
安装
要安装此插件,请按照以下说明操作。
-
打开您的终端并转到您的 Craft 项目
cd /path/to/project -
然后告诉 Composer 加载插件
composer require mildlygeeky/craft-kint -
在控制面板中,转到设置 → 插件,并为 Kint 点击“安装”按钮。
Kint 概述
Kint 是一个用于 PHP 应用的交互式调试器。完整的文档可以在 https://github.com/kint-php/kint/ 找到。
其优点包括可以在 devMode 外运行(尽管您不会想在一个公开设置中使用它),并且它是交互式的,具有键盘快捷键来展开和折叠对象,将内容与方法分开等。
配置 Kint
无需配置,但您可以在插件设置屏幕中设置 Kint 将使用的主题。
使用 Kint
- 点击条上的任何位置以展开它
- 双击加号以展开所有子项
- 按 d 键切换键盘导航。
- 按右侧的“⇄”图标可以看到您需要使用什么代码来获取某个数据。
- 按右侧的“⌕”图标以打开实时搜索。
- 切换选项卡以查看数据的不同视图。
- 您可以通过单击标题来对数据表进行排序。
模板化
d (dump)
{{ d(entry) }} 或 {{ d(entry, otherEntry) }}
这是最简单的用法,将为传入的变量输出一个交互式调试器。
j (dump - console.log())
{{ j(entry) }} 或 {{ j(entry, otherEntry) }}
这与 d 相同,但所有输出都将发送到 console.log()
s (simple dump)
{{ s(someTwigVariable) }} 或 {{ s(entry, otherEntry) }}
这与内置的 Twig dump 方法基本相同,并返回纯文本调试输出。
microtime (时间点内存使用和时间戳)
{{ microtime() }} 和 {{ microtime(true) }} 来重置计数器
在命令运行时基本报告内存使用情况以及时间戳。如果多次使用,还将报告自上次调用以来的时间以及平均持续时间。将true作为参数传递将重置计数器。
跟踪(回溯)
{{ trace() }}
从函数被调用的点输出PHP回溯 - 注意,此函数使用相当多的内存(您可能需要设置memory_limit 512M,并且输出可能不太有帮助,因为您将主要看到从Twig模板编译的PHP代码。)
致谢
- 感谢Jonathan Vollebregt和Rokas Šleinius,他们是Kint的开发者。
