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 & Quality](/categories/testing)
4. /
5. dossierdata/phpunit-finder

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

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

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

v3.1.0(7mo ago)01.9k↑13.5%GPL-2.0-or-laterPHPPHP ^8.1||^8.2||^8.3

Since Mar 5Pushed 7mo 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 2w 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

49

—

FairBetter than 94% of packages

Maintenance65

Regular maintenance activity

Popularity21

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

210d 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.5k142.8M1.1k](/packages/brianium-paratest)[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.2k30.0M2.8k](/packages/infection-infection)[testo/testo

A lightweight PHP testing framework.

20319.6k179](/packages/testo-testo)

PHPackages © 2026

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