net-tools/phpunit-dump

Composer library to dump data generated from a PHPUnit testsuite

Maintainers

Details

github.com/net-tools/phpunit-dump

Source

Issues

Installs: 49

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 2

Forks: 0

Open Issues: 0

1.0.14 2023-04-18 19:01 UTC

Requires

  • php: >= 8.0

Requires (Dev)

MIT ee16e10008d6a4f1651f29be9e6e678b04bb10ea

  • Pierre <dev.woop@nettools.ovh>

This package is auto-updated.

Last update: 2024-12-18 22:47:15 UTC

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).