Var-dumper requires the iconv extension. I was using it on a freshly installed PHP instance and got the following fatal error:

Error: Call to undefined function Symfony\Component\VarDumper\Dumper\iconv_strlen() in Symfony\Component\VarDumper\Dumper\CliDumper->dumpString() (line 172 of vendor/symfony/var-dumper/Dumper/CliDumper.php).

We may want to see the output based on the conditions, so dd_if will make our job easier.

$value = 1;
$data = [1, 2, 3, 4, 5];

dd_if(in_array($value, $data));

| Q | A | ------------- | --- | Branch? | 6.2 | Bug fix? | no | New feature? | yes | Deprecations? | no

Added support of FFI:

$ffi = \FFI::cdef(<<<'CPP'
    typedef struct { int x; int y; } Point;
    typedef struct Example {
        uint8_t array[32];
        long longVal;
        __extension__ union {
            __extension__ struct { short shortVal; };
            struct { Point point; float e; };
        };
        bool boolValue;
        int (*func)(struct __sub *h);
    } Example;
CPP);

$struct = $ffi->new('Example');
$struct->func = (static fn (object $ptr) => 42);

dump($struct);

Before

FFI\CData {#2}

After

FFI\CData<struct Example> size 64 align 8 {#2
  +array: FFI\CData<uint8_t[32]> size 32 align 1 {#18}
  +int32_t longVal: 0
  +int16_t shortVal: 0
  +point: FFI\CData<struct <anonymous>> size 8 align 4 {#17
    +int32_t x: 0
    +int32_t y: 0
  }
  +float e: 0.0
  +bool boolValue: false
  +func: [cdecl] callable(struct __sub*): int32_t {#20
    returnType: FFI\CType<int32_t> size 4 align 4 {#25}
  }
}

Adds ddc helper function as an exhaustive version of dump.

ddc stands for: Die Dump Count

There is a lot of time when the first call to the dd() is not what we want. on the other hand, dump() does not have a break and prints out much more than we want.

This is something in between dd and dump. For example, we want to see what parameters are passed to a method, but that method is called multiple times and the first couple of calls does not matter to us. Or any other debug a process which involves a loop

<?php

$i = 0;
while (true) {
    $i++;
    ddc(4, $i);         // dumps 1, 2, 3, 4 then dies
    ddc([0, 4], $i);    // same as ddc(4, $i); 
}

$i = 0;
while (true) {
    $i++;
    ddc([2,4], $i);   // dumps 3, 4 (skips 1, 2)
}

We can see the objects with namespace that help us to navigate to the file easily.

Before: These are diffrent Collection class

Now: we can see the diffrent

Possibility to replace existing css style for HTMLDumper without replacing the whole css class definition like changing background-color, font or word-break, etc

e.g.

$dumper->changeStyle('default', 'word-break', 'break-word') would change css style of word-break to break-word from break-all

Calling the dump() method for the first time is not producing any output. That's because, in the latest change, the first call to the dump method is not calling the $handler at all. It's just setting the $handler. In this PR, I've tried to fix this issue.

If the ClassStub needs to work with a class closure, it will throw a FatalErrorException. I got this:

FatalErrorExceptionError: __debuginfo() must return an array
--
in ClassStub.php line 56
at ReflectionMethod->__construct('\'eZ\\\\Publish\\\\Core\\\\Base\\\\Container\\\\ApiLoader\\\\Storage\\\\ExternalStorageRegistryFactory\'', '\'eZ\\\\Publish\\\\Core\\\\Base\\\\Container\\\\ApiLoader\\\\Storage\\\\{closure}\'') in ClassStub.php line 56
at ClassStub->__construct('identifier' => '\'eZ\\\\Publish\\\\Core\\\\Base\\\\Container\\\\ApiLoader\\\\Storage\\\\ExternalStorageRegistryFactory->eZ\\\\Publish\\\\Core\\\\Base\\\\Container\\\\ApiLoader\\\\Storage\\\\{closure}\'', 'callable' => '???') in ExceptionCaster.php line 163
...

This bugfix handles this situation.

The return type used here will throw an error:

Fatal error: Uncaught TypeError: Return value of Symfony\Component\VarDumper\Dumper\ServerDumper::dump() must be an instance of Symfony\Component\VarDumper\Dumper\void, none returned

This PR simply removes it.

On some systems creating async TCP connection results in "failed to open stream: Resource temporarily unavailable" exception. To solve this, added VAR_DUMPER_ASYNC variable, which is true by default, so won't affect default behavior.

If one faces "failed to open stream: Resource temporarily unavailable" error, he should add VAR_DUMPER_ASYNC=0 to .env file, and problem would be solved.