Merge multiple PHPUnit reports into one file
Installs: 477 937
Open Issues: 10
- php: ^7.0.8 || ^8.0
- ext-dom: *
- ext-json: *
- ext-simplexml: *
- phpunit/php-code-coverage: >=5.0 <10.0
- symfony/console: >=2.7 <6.0
- symfony/finder: >=2.7 <6.0
- phpunit/phpunit: >=6.0 <10.0
- symfony/filesystem: >=2.7 <6.0
- friendsofphp/php-cs-fixer: Tool to automatically fix PHP coding standards issues
Sometimes it is necessary to run multiple PHPUnit instances to execute all tests of a project. Unfortunately each run writes its own coverage and log reports. There is no support in PHPUnit to merge the reports of multiple runs.
This project provides two commands to merge coverage files as well as log files. It was designed to provide merged reports to e.g. SonarQube Scanner for further processing.
Use Composer to install the testing framework.
$ composer require --dev nimut/phpunit-merger
Composer will add the package as a dev requirement to your composer.json and install the package with its dependencies.
The coverage command merges files containing PHP_CodeCoverage objects into one file in Clover XML format.
$ vendor/bin/phpunit-merger coverage <directory> [--html=<directory>] [<file>]
directory: Directory containing one or multiple files with PHP_CodeCoverage objects
file: File where the merged result should be stored. Default: Standard output
html: Directory where the HTML report should be stored
lowUpperBound: (optional) The lowUpperBound value to be used for HTML format
highLowerBound: (optional) The highLowerBound value to be used for HTML format
The log command merges files in JUnit XML format into one file in JUnit XML format.
$ vendor/bin/phpunit-merger log <directory> <file>
directory: Provides the directory containing one or multiple files in JUnit XML format
file: File where the merged result should be stored