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-mergerComposer 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>]Arguments
directory: Directory containing one or multiple files with PHP_CodeCoverage objectsfile: File where the merged result should be stored. Default: Standard output
Options
html: Directory where the HTML report should be storedlowUpperBound: (optional) The lowUpperBound value to be used for HTML formathighLowerBound: (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>Arguments
directory: Provides the directory containing one or multiple files in JUnit XML formatfile: File where the merged result should be stored