perchten / neat_html
在html、json等格式中格式化打印PHP对象和数组。
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文件以获取详细信息。