perchten/neat_html

在html、json等格式中格式化打印PHP对象和数组。

1.4.1 2014-08-15 12:58 UTC

This package is not auto-updated.

Last update: 2024-09-14 15:40:20 UTC


README

更美观的php对象和数组html打印

安装

通过Composer

Neat_html可在Packagist上找到(perchten/neat_html)并且可以通过Composer进行安装。

将以下内容添加到您的composer.json

{
	"require": {s
    	"perchten/neat_html": "1.*"
    }
}
直接包含

GitHub克隆或下载,并将其直接包含在您的代码中

require_once "path/to/neat_html.php"

用法

简单的neat_html
neat_html($somevar)

$somevar打印成html,并以类似JSON的格式包裹在<pre>块中。

返回,不打印
$output = neat_html($somevar,true)

neat_html($somevar)类似,但输出被返回,并捕获在变量$output中,而不是打印。

在调试打印后立即终止
neat_html($somevar,"die")

输出格式化的$somevar,然后终止。

作为HTML注释输出
neat_html($somevar,"comment")

以注释形式输出格式化的代码。注释以<!--neat_html开始,便于搜索。

不要包裹在<pre>标签中
neat_html($somevar,"nopre")

不包裹在<pre>标签中输出格式化的代码。对于控制台打印非常有用。

打印包含的文件
neat_html($somefileref,'include)

将$somefileref作为文件引用,并包含该文件的全部内容。显然,如果包含的文件使用了未定义的变量,那么它将失败。

此外,文件引用必须是绝对路径。为了方便,包含了一个truepath函数来获取真实路径。(PHP的realpath()函数有点问题,所以最好不要使用它。请参阅http://stackoverflow.com/questions/4049856/replace-phps-realpath)。例如:

neat_html(truepath($somefileref),'include')
以JSON格式输出(适用于Ajax)
neat_html($somevar,'json')

以JSON格式返回对象。当调试通过Ajax且期望JSON响应时非常有用。

以PHP格式输出(适用于纯主义者)
neat_html($somevar,'php')

以PHP格式返回对象。这然后使用var_export函数而不是print_r。因此,这里返回的值甚至可以直接解释为PHP变量。

多个参数

您还可以将多个参数作为一个第二参数数组收集,如下所示

neat_html($somevar,array("include","comment","return");

或者作为逗号或空格分隔的列表

neat_html($somevar,"include, comment, return");

并且,从v1.2版本开始,您甚至可以使用动态参数

neat_html($somevar,"include","comment","return");
var_dump
neat_html($somevar,'dump');

这将对所有数据操作进行操作$somevar(包括如果它是文件包含),然后var_dump结果并附加到任何其他指定的格式输出。

默认值

如果您总是重复相同的可选参数,您可以在全局级别设置默认值。

Neat_Html::setDefault($option);

Neat_Html::getDefaults();

Neat_Html::setDefaults($optionsArray);

Neat_Html::removeDefault($option);	
启用/禁用

neat_html语句默认将运行,但您可以通过全局切换该功能以及查询当前状态来控制。

Neat_Html::setOn() // switches this module on globally

Neat_Html::setOff() // switches this module off globally

Neat_Html::isOn() // return true if module is on, otherwise false

许可

Neat_html受MIT许可的许可 - 请参阅LICENSE文件以获取详细信息。