Skip to content

Document new environment variables and display options #7217

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 9 commits into from
Apr 15, 2017
Merged

Document new environment variables and display options #7217

Changes from 4 commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
7b26e44
Document new environment variables and display options
sawmurai Dec 3, 2016
adbec6d
Reformat documentation and link to class doc.
sawmurai Dec 3, 2016
9340846
Replaced the list to use an unordered list
javiereguiluz Dec 3, 2016
dfb6d6a
Trimmed some lines to respect the 80-char soft limit
javiereguiluz Dec 3, 2016
ad90321
Describe flags in more detail
sawmurai Dec 3, 2016
6b2248e
Fix mention of file
sawmurai Dec 3, 2016
0c46fce
Respect 80 chars line length
sawmurai Dec 3, 2016
2ef1b60
Fix format
Dec 8, 2016
29080a6
Minor formatting changes
javiereguiluz Apr 15, 2017
File filter

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 22 additions & 1 deletion components/var_dumper/advanced.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -97,7 +97,12 @@ Dumpers

A dumper is responsible for outputting a string representation of a PHP variable,
using a :class:`Symfony\\Component\\VarDumper\\Cloner\\Data` object as input.
The destination and the formatting of this output vary with dumpers.
The destination and the formatting of this output vary with dumpers and are
influenced by two environment variables:

* If ``DUMP_STRING_LENGTH`` is set, then the length of a string is displayed
next to its content.
* If ``DUMP_LIGHT_ARRAY`` is set, then arrays are not displayed completely.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't fully understand the purpose of this option. Looking for DUMP_LIGHT_ARRAY in the code didn't help me either. What does exactly this option do? Thanks!
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I described the flags in more detail now and moved the section to the end of the paragraph. :)

This component comes with an :class:`Symfony\\Component\\VarDumper\\Dumper\\HtmlDumper`
for HTML output and a :class:`Symfony\\Component\\VarDumper\\Dumper\\CliDumper`
Expand Down Expand Up @@ -181,6 +186,22 @@ method. They also typically implement the
them from re-implementing the logic required to walk through a
:class:`Symfony\\Component\\VarDumper\\Cloner\\Data` object's internal structure.

The :class:`Symfony\\Component\\VarDumper\\Dumper\\HtmlDumper` limits string
length and nesting depth of the output. These options can be overriden by
providing a third parameter when calling ``dump``::

use Symfony\Component\VarDumper\Dumper\HtmlDumper;

$output = fopen('php://memory', 'r+b');

$dumper = new HtmlDumper();
$dumper->dump($var, $output, array(
'maxDepth' => 1,
'maxStringLength' => 160
));

// Limit nesting to 1 level and string length to 160 characters (default)

Casters
-------

Expand Down