PHPackages                             dossierdata/phpunit-finder - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Testing &amp; Quality](/categories/testing)
4. /
5. dossierdata/phpunit-finder

ActiveLibrary[Testing &amp; Quality](/categories/testing)

dossierdata/phpunit-finder
==========================

PHP lib for finding and outputting all tests from a phpunit.xml config file.

v3.1.0(3mo ago)0801↓33.3%GPL-2.0-or-laterPHPPHP ^8.1||^8.2||^8.3

Since Mar 5Pushed 3mo agoCompare

[ Source](https://github.com/dossierdata/phpunit-finder)[ Packagist](https://packagist.org/packages/dossierdata/phpunit-finder)[ RSS](/packages/dossierdata-phpunit-finder/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (5)Versions (15)Used By (0)

PHPUnit Finder
==============

[](#phpunit-finder)

This is a helper CLI tool that queries phpunit.xml files to get a list of test filenames and print them. This is useful if you want to split tests to run them in parallel based on timings on CI tools such as CirclCI.

Installation
------------

[](#installation)

Install with composer:

`composer require --dev previousnext/phpunit-finder`

Usage
-----

[](#usage)

You can run with defaults using:

`./vendor/bin/phpunit-finder`

By default, it will look for all test suites to scan.

You can filter by specific test suites as follows:

`./vendor/bin/phpunit-finder unit kernel`

Configuration
-------------

[](#configuration)

phpunit-finder assumes you have a phpunit.xml in the root of your project. You can override the path using the `--config-file` option.

It also assumes your tests bootstrap file is found in `tests/bootstrap.php`. You can override this with the `--bootstrap-file` option.

###  Health Score

51

—

FairBetter than 96% of packages

Maintenance78

Regular maintenance activity

Popularity18

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity83

Battle-tested with a long release history

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~228 days

Recently: every ~329 days

Total

12

Last Release

119d ago

Major Versions

1.3.0 → 2.0.02021-06-21

2.0.2 → v3.0.02025-01-03

2.1.0 → v3.1.02026-01-19

PHP version history (4 changes)1.0.0-alpha1PHP ^7.1

1.3.0PHP ^7.2||^8.0

2.0.0PHP ^7.4||^8.0

v3.0.0PHP ^8.1||^8.2||^8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/276ac615994962c132eb8c6af822850eecf36cf6482969c673fe0d95a1266a9d?d=identicon)[lucasvdh](/maintainers/lucasvdh)

---

Top Contributors

[![kimpepper](https://avatars.githubusercontent.com/u/6132?v=4)](https://github.com/kimpepper "kimpepper (18 commits)")[![larowlan](https://avatars.githubusercontent.com/u/555254?v=4)](https://github.com/larowlan "larowlan (12 commits)")[![mstrelan](https://avatars.githubusercontent.com/u/665110?v=4)](https://github.com/mstrelan "mstrelan (8 commits)")[![lucasvdh](https://avatars.githubusercontent.com/u/4311594?v=4)](https://github.com/lucasvdh "lucasvdh (3 commits)")[![acbramley](https://avatars.githubusercontent.com/u/569927?v=4)](https://github.com/acbramley "acbramley (1 commits)")

---

Tags

testing

### Embed Badge

![Health badge](/badges/dossierdata-phpunit-finder/health.svg)

```
[![Health](https://phpackages.com/badges/dossierdata-phpunit-finder/health.svg)](https://phpackages.com/packages/dossierdata-phpunit-finder)
```

###  Alternatives

[brianium/paratest

Parallel testing for PHP

2.5k118.8M754](/packages/brianium-paratest)[behat/behat

Scenario-oriented BDD framework for PHP

4.0k96.8M2.0k](/packages/behat-behat)[orchestra/testbench

Laravel Testing Helper for Packages Development

2.2k39.1M32.1k](/packages/orchestra-testbench)[infection/infection

Infection is a Mutation Testing framework for PHP. The mutation adequacy score can be used to measure the effectiveness of a test set in terms of its ability to detect faults.

2.2k26.2M1.8k](/packages/infection-infection)[phpbench/phpbench

PHP Benchmarking Framework

2.0k13.0M627](/packages/phpbench-phpbench)[timacdonald/log-fake

A drop in fake logger for testing with the Laravel framework.

4235.9M56](/packages/timacdonald-log-fake)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
