library neat_html

perchten/neat_html

Pretty-print PHP objects and arrays in html, json etc.

neat_html

Prettier html printing of php objects and arrays, _(*1)

Installation

Via Composer

Neat_html is available on Packagist (perchten/neat_html) and as such is installable via Composer., _(*2)

Add the following to your composer.json, _(*3)

{
    "require": {s
        "perchten/neat_html": "1.*"
    }
}

Direct include

Clone or download from GitHub and include directly in your code:, _(*4)

require_once "path/to/neat_html.php"

Usage

Simple neat_html

neat_html($somevar)

Will print $somevar into html as a <pre>-wrapped block formatted like JSON., _(*5)

Return, Don't Print

$output = neat_html($somevar,true)

As with neat_html($somevar) except that the output is returned, captured in the $output variable and not printed., _(*6)

Die Immediately After Debug Print

neat_html($somevar,"die")

Outputs the formatted $somevar and then dies., _(*7)

Output as Html Comment

neat_html($somevar,"comment")

Outputs the formatted code in comment form. comments start <!--neat_html for easy searching., _(*8)

Do not wrap in <pre> tags

neat_html($somevar,"nopre")

Outputs the formatted code without wrapping it in <pre> tags. Useful for console printing., _(*9)

Print Included Files

neat_html($somefileref,'include)

Takes $somefileref as a file reference and includes that file's contents. Obviously, if the included file uses undefined variables then it will fail., _(*10)

Also, the file reference must be absolute. For convenience a truepath function is included to get the real path. (PHP's realpath() function is a bit buggy, so best not use that. see http://stackoverflow.com/questions/4049856/replace-phps-realpath). e.g., _(*11)

neat_html(truepath($somefileref),'include')

Output in JSON (Handy For Ajax)

neat_html($somevar,'json')

Returns the object in json notation. Handy when debugging over ajax that expects a json response., _(*12)

Output in PHP (Handy For Purists ;))

neat_html($somevar,'php')

Returns the object in php notation. This then uses the var_export function instead of print_r. So the returned values here can even be interpreted directly as php variables., _(*13)

Multiple Arguments

You can also collect multiple arguments together in a second argument array as follows:, _(*14)

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

Or as a comma or space separated list:, _(*15)

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

And, as of v1.2 you can even use dynamic arguments:, _(*16)

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

var_dump

neat_html($somevar,'dump');

This will run all data manipulation on $somevar (including if it is a file include), and then var_dump the result in addition to outputting in any other specified formatting., _(*17)

Defaults

You can set defaults at a global level if you find yourself repeating the same optional arguments all the time., _(*18)

Neat_Html::setDefault($option);

Neat_Html::getDefaults();

Neat_Html::setDefaults($optionsArray);

Neat_Html::removeDefault($option);  

Enabling/Disabling

neat_html statements will run by default, but you can control this by switching the functionality on and off globally, and querying the current state., _(*19)

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

License

Neat_html is licensed under the MIT License - see the LICENSE file for details, _(*20)