net-tools / phpunit-dump
Composer library to dump data generated from a PHPUnit testsuite
Requires
- php: >= 8.0
Requires (Dev)
- mikey179/vfsstream: ^1.0.0
- phpunit/phpunit: ^10.0.0
README
Composer library to dump data from a PHPUnit testsuite
Sometimes we have to check some data produced by a unit test, but this can't be done with PHPUnit assertions.
This library makes it possible do dump this data to a file or to have the dump sent to a mail recipient, for further inspection.
Setup instructions
To install net-tools/phpunit-dump package, just require it through composer : require net-tools/phpunit-dump:^1.0.0
.
How to use ?
The extension must be registered in PHPUnit xml config file. For example, to register DumpToMail
extension class :
<extensions> <bootstrap class="Nettools\PHPUnitDump\DumpToMail"> <parameter name="recipient" value="to@mydomain.tld"/> <parameter name="from" value="phpunit@mydomain.tld"/> <parameter name="body" value="email body text"/> </bootstrap> </extensions>
The other PHPUnit extension class is DumpToFile
which write all data to files inside a given path :
<bootstrap class="Nettools\PHPUnitDump\DumpToFile"> <parameter name="path" value="path/to/file"/> </bootstrap>
Then, during a test, call the static method DumpExtension::dump($name, $data)
to create a dump value ; $data
and $name
are string values (in the case of DumpToFile
, $name
will be the filename created for this dump).
At the end of the whole PHPUnit test, the values will be dumped (to files or as mail attachments).