class CliDumper extends AbstractDumper

CliDumper dumps variables for command line output.

Constants

DUMP_LIGHT_ARRAY

DUMP_STRING_LENGTH

DUMP_COMMA_SEPARATOR

DUMP_TRAILING_COMMA

Properties

static $defaultOutput
protected $line from AbstractDumper
protected $lineDumper from AbstractDumper
protected $outputStream from AbstractDumper
protected $decimalPoint from AbstractDumper
protected $indentPad from AbstractDumper
protected $flags from AbstractDumper
static $defaultColors
protected $colors
protected $maxStringWidth
protected $styles
static protected $controlCharsRx
static protected $controlCharsMap
protected $collapseNextHash
protected $expandNextHash

Methods

__construct(callable|resource|string|null $output = null, string $charset = null, int $flags = 0)

No description

callable|resource|string
setOutput(callable|resource|string $output)

Sets the output destination of the dumps.

string
setCharset(string $charset)

Sets the default character encoding to use for non-UTF8 strings.

string
setIndentPad(string $pad)

Sets the indentation pad string.

dump(Data $data, callable|resource|string|true|null $output = null)

Dumps a Data object.

dumpLine(int $depth, $endOfValue = false)

Dumps the current line.

echoLine(string $line, int $depth, string $indentPad)

Generic line dumper callback.

string
utf8Encode(string $s)

Converts a non-UTF-8 string to UTF-8.

setColors(bool $colors)

Enables/disables colored output.

setMaxStringWidth(int $maxStringWidth)

Sets the maximum number of characters per line for dumped strings.

setStyles(array $styles)

Configures styles.

dumpScalar(Cursor $cursor, string $type, string|int|float|bool $value)

Dumps a scalar value.

dumpString(Cursor $cursor, string $str, bool $bin, int $cut)

Dumps a string.

enterHash(Cursor $cursor, int $type, string $class, bool $hasChild)

Dumps while entering an hash.

leaveHash(Cursor $cursor, int $type, string $class, bool $hasChild, int $cut)

Dumps while leaving an hash.

dumpEllipsis(Cursor $cursor, bool $hasChild, int $cut)

Dumps an ellipsis for cut children.

dumpKey(Cursor $cursor)

Dumps a key in a hash structure.

string
style(string $style, string $value, array $attr = [])

Decorates a value with some style.

bool
supportsColors()

No description

endValue(Cursor $cursor)

No description

Details

at line 61
__construct(callable|resource|string|null $output = null, string $charset = null, int $flags = 0)

Parameters

callable|resource|string|null $output A line dumper callable, an opened stream or an output path, defaults to static::$defaultOutput
string $charset The default character encoding to use for non-UTF8 strings
int $flags A bit field of static::DUMP_* constants to fine tune dumps representation

in AbstractDumper at line 64
callable|resource|string setOutput(callable|resource|string $output)

Sets the output destination of the dumps.

Parameters

callable|resource|string $output A line dumper callable, an opened stream or an output path

Return Value

callable|resource|string The previous output destination

in AbstractDumper at line 89
string setCharset(string $charset)

Sets the default character encoding to use for non-UTF8 strings.

Parameters

string $charset The default character encoding to use for non-UTF8 strings

Return Value

string The previous charset

in AbstractDumper at line 108
string setIndentPad(string $pad)

Sets the indentation pad string.

Parameters

string $pad A string that will be prepended to dumped lines, repeated by nesting level

Return Value

string The previous indent pad

in AbstractDumper at line 124
dump(Data $data, callable|resource|string|true|null $output = null)

Dumps a Data object.

Parameters

Data $data
callable|resource|string|true|null $output A line dumper callable, an opened stream, an output path or true to return the dump

at line 507
protected dumpLine(int $depth, $endOfValue = false)

Dumps the current line.

Parameters

int $depth The recursive depth in the dumped structure for the line being dumped, or -1 to signal the end-of-dump to the line dumper callable
$endOfValue

in AbstractDumper at line 178
protected echoLine(string $line, int $depth, string $indentPad)

Generic line dumper callback.

Parameters

string $line The line to write
int $depth The recursive depth in the dumped structure
string $indentPad The line indent pad

in AbstractDumper at line 192
protected string utf8Encode(string $s)

Converts a non-UTF-8 string to UTF-8.

Parameters

string $s The non-UTF-8 string to convert

Return Value

string The string converted to UTF-8

at line 86
setColors(bool $colors)

Enables/disables colored output.

Parameters

bool $colors

at line 96
setMaxStringWidth(int $maxStringWidth)

Sets the maximum number of characters per line for dumped strings.

Parameters

int $maxStringWidth

at line 106
setStyles(array $styles)

Configures styles.

Parameters

array $styles A map of style names to style definitions

at line 114
dumpScalar(Cursor $cursor, string $type, string|int|float|bool $value)

Dumps a scalar value.

Parameters

Cursor $cursor The Cursor position in the dump
string $type The PHP type of the value being dumped
string|int|float|bool $value The scalar value being dumped

at line 168
dumpString(Cursor $cursor, string $str, bool $bin, int $cut)

Dumps a string.

Parameters

Cursor $cursor The Cursor position in the dump
string $str The string being dumped
bool $bin Whether $str is UTF-8 or binary encoded
int $cut The number of characters $str has been cut by

at line 256
enterHash(Cursor $cursor, int $type, string $class, bool $hasChild)

Dumps while entering an hash.

Parameters

Cursor $cursor The Cursor position in the dump
int $type A Cursor::HASH_* const for the type of hash
string $class The object class, resource type or array count
bool $hasChild When the dump of the hash has child item

at line 292
leaveHash(Cursor $cursor, int $type, string $class, bool $hasChild, int $cut)

Dumps while leaving an hash.

Parameters

Cursor $cursor The Cursor position in the dump
int $type A Cursor::HASH_* const for the type of hash
string $class The object class, resource type or array count
bool $hasChild When the dump of the hash has child item
int $cut The number of items the hash has been cut by

at line 306
protected dumpEllipsis(Cursor $cursor, bool $hasChild, int $cut)

Dumps an ellipsis for cut children.

Parameters

Cursor $cursor The Cursor position in the dump
bool $hasChild When the dump of the hash has child item
int $cut The number of items the hash has been cut by

at line 324
protected dumpKey(Cursor $cursor)

Dumps a key in a hash structure.

Parameters

Cursor $cursor The Cursor position in the dump

at line 412
protected string style(string $style, string $value, array $attr = [])

Decorates a value with some style.

Parameters

string $style The type of style being applied
string $value The value being styled
array $attr Optional context information

Return Value

string The value with style decoration

at line 467
protected bool supportsColors()

Return Value

bool Tells if the current output stream supports ANSI colors or not

at line 515
protected endValue(Cursor $cursor)

Parameters

Cursor $cursor