aronduby/dump

D::ump - a PHP 5.4 print_r/var_dump replacement base on Krumo

D::ump

A print_r/var_dump replacement for PHP >= 5.4.0 based on Krumo and the oodle/krumo fork., _(*1)

, _(*2)

Differences from Krumo

• modified HTML, CSS, and JS has been completely reworked, makes multiple arguments passed look like they're together
• added Passing in bitmask to be able to do Titles, Output Buffering, and Stopping Executing after output
• added Object Reflection to not only show the properties (which are now sorted as arrays) but also:
  • Parent Class Name
  • Interface Names
  • Trait Names
  • Constants
  • Methods (with the argument list and defaults*)
• added Callables are now first class citizens instead of strings, complete with argument list and defaults* from reflection
• removed All the different skins, if you really want it to look different there's a css_file config option, but who cares, its development
• removed All the helper functions, because why not just type D::ump($_ENV), not like your going to remember them all anyway
• removed .ini settings file is gone, use D::config() if you want to set global changes
• probably some other things...

Note: reflection can't get the default values for arguments of built-in methods/functions, it will display the argument name with a note in these circumstances, _(*3)

Install

Using Composer

{
    "require": {
        "aronduby/dump" : "*"
    }
}

then run composer install or composer update, _(*4)

Usage

Basic Usage

D::ump($arg1);

You can also pass multiple arguments:, _(*5)

D::ump($arg1, $arg2, $arg3);

Dump Settings

If you pass an instance of D\DumpSettings as the last argument to D::ump you can set a title, output buffer the return, kill the process after returning, and expand all the collapsibles by default., _(*6)

$ds = new \D\DumpSettings(D::KILL | D::EXPAND, 'This is a Title');
D::ump($arg1, $arg2, $ds);

Short Cut:

The D object has a shortcut to quickly create and return an instance of D\DumpSettings, so the same example could be rewritten as, _(*7)

D::ump($arg1, $arg2, D::S(D::KILL | D::EXPAND, 'This is a Title'));

Flags

The following flags are available as constants of the D class: - D::KILL -- will call die() after output - D::OB -- will use the output buffer and return the output instead of printing it - D::EXPAND -- starts with the output fully expanded - D::IGNORE_CLI -- by default, if the script detects you are running command line it just uses print_r, use this to include the full output, useful if you are doing html logging, _(*8)

Note: Passing a bitmask containing both D::KILL and D::OB will result in an InvalidArgumentException being thrown since you can't do both Note: D\DumpSettings also has a backtrace property which is used by D::ump(), _(*9)

Config

You can globally modify the following properties by passing an associative array into D::config($arr) with the following values, _(*10)

Example

D::config([
    'css_file' => "absolute/path/to/your/custom/css/file.css",
    'display.cascade' => [5, 10],
    'sorting.arrays' => false
]);
// ... some other stuff in your code
D::ump($arg1);