regulus/exterminator

一个简单的 Laravel 4 调试 composer 包,允许您在屏幕上根据是否存在 'debug' cookie 输出彩色变量。

dev-master 2014-01-11 04:11 UTC

This package is auto-updated.

Last update: 2024-09-27 05:55:47 UTC


README

一个简单的 Laravel 4 调试 composer 包,允许您在屏幕上根据是否存在 'debug' cookie 输出彩色变量。

变量输出是彩色编码的,描述性堪比 PHP 的 var_dump() 方法。您可以通过点击“隐藏”按钮来隐藏 Exterminator 窗口,也可以通过单击任何变量来选择其整个内容。这些功能使得 Exterminator 比简单的 var_dump 要友好得多。

使用 Dbg::display() 方法,您可以在视图的末尾输出所有变量,以防止任何数据输出破坏您的渲染 HTML 页面。变量输出也包含在 HTML 标记中,并使用各种 JavaScript 方法进行增强,如上所述。

安装

要安装 Exterminator,请确保 "regulus/exterminator" 已添加到 Laravel 4 的 composer.json 文件。

"require": {
	"regulus/exterminator": "dev-master"
},

然后从命令行运行 php composer.phar update。Composer 会安装 Exterminator 包。现在,您只需在 app/config/app.php 中注册服务提供者并设置 Exterminator 的别名即可。将以下内容添加到 providers 数组

'Regulus\Exterminator\ExterminatorServiceProvider',

并将以下内容添加到 aliases 数组

'Dbg' => 'Regulus\Exterminator\Exterminator',

您可以使用 'Exterminator'、'Debug' 或其他别名,但出于简洁性考虑,建议使用 'Dbg'。现在 Exterminator 已准备就绪。

启用 Exterminator

要启用 Exterminator,请转到 http://site.com/debug/debug1913。这将通过在您的机器上放置一个 cookie 来启用查看 Exterminator 的数据输出。请注意,debug1913 部分是您的 Exterminator 访问代码,可以在 config.php 中进行配置。

使用方法

基本使用方法

在设置您的 debug cookie 后显示变量

$var = array(
	'boolean' => true,
	'number'  => 3.43,
	'string'  => 'Testing Exterminator',
	'array'   => array(
		'boolean' => false,
		'number'  => 5,
		'object'  => (object) array(
			'Number One',
			2,
			3.0,
		),
	),
);
Dbg::display($var);

显示多个变量

要显示多个变量,请使用 Exterminator 的 "添加" 方法 Dbg::a()

Dbg::a($var);
Dbg::a($var2);

然后,在网站页脚中添加一个简单的 Dbg::display(),不带任何参数

		<?php Dbg::display(); ?>
	</body>
</html>

向输出变量添加变量名

您可以使用 PHP 的 get_defined_vars() 来获取变量名,显示在输出变量的右上角。请注意,这可能在所有情况下都不适用。以下是操作方法

$definedVars = get_defined_vars();

Dbg::a($var, $definedVars);
Dbg::a($var2, $definedVars);

您还可以通过传递字符串作为第二个参数来手动设置变量名

Dbg::a($var, 'var');