PHPackages                             ockcyp/covers-validator - 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. ockcyp/covers-validator

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

ockcyp/covers-validator
=======================

Validates @covers tags in PHPUnit tests

v1.7.0(8mo ago)22208.4k↑180%8[1 issues](https://github.com/oradwell/covers-validator/issues)20MITPHPPHP ^7.1 || ^8.0CI failing

Since Oct 28Pushed 8mo ago3 watchersCompare

[ Source](https://github.com/oradwell/covers-validator)[ Packagist](https://packagist.org/packages/ockcyp/covers-validator)[ RSS](/packages/ockcyp-covers-validator/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (10)Dependencies (2)Versions (26)Used By (20)

covers-validator
================

[](#covers-validator)

[![CI](https://github.com/oradwell/covers-validator/actions/workflows/ci.yaml/badge.svg)](https://github.com/oradwell/covers-validator/actions/workflows/ci.yaml)[![Coverage Status](https://camo.githubusercontent.com/c823be0806f07f9752f4c2996dc1ca8d2f816cfcf3afaaf0abb5572d749803d0/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f6f72616477656c6c2f636f766572732d76616c696461746f722f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/oradwell/covers-validator?branch=master)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/2f16018e39e72794d5ba839b4aee8001b141f9e4af295ed5fd2ff4e14703bd88/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6f72616477656c6c2f636f766572732d76616c696461746f722f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/oradwell/covers-validator/?branch=master)[![License](https://camo.githubusercontent.com/2071190789bed7a22f92eaffef5409a766d974e1fa89d0e09044a2666c1950c7/68747470733a2f2f706f7365722e707567782e6f72672f6f636b6379702f636f766572732d76616c696461746f722f6c6963656e7365)](https://packagist.org/packages/ockcyp/covers-validator)[![Total Downloads](https://camo.githubusercontent.com/063f2b88bd126bd291c7311819b7b0f7c8bd51eb3fbf385b192ae24bbda66476/68747470733a2f2f706f7365722e707567782e6f72672f6f636b6379702f636f766572732d76616c696461746f722f646f776e6c6f616473)](https://packagist.org/packages/ockcyp/covers-validator)

PHPUnit @covers tags validator

Why?
----

[](#why)

[PHPUnit](https://github.com/sebastianbergmann/phpunit) fails to generate a coverage report when tests have invalid [@covers](https://docs.phpunit.de/en/10.5/annotations.html#covers)tags.

This tool allows you to determine the tests that have invalid @covers tags without you needing to run the coverage.

Usually coverage reports are run less often than the tests as they take a long time to run. This tool validates your @covers tags quicker than you run your tests.

```
Trying to @cover or @use not existing class or interface "NonExistentClass".
Trying to @cover or @use not existing method "ExistingClass::nonExistantMethod".

```

See: [phpunit/issues/1758](https://github.com/sebastianbergmann/phpunit/issues/1758)
Also see: [phpunit/issues/1791](https://github.com/sebastianbergmann/phpunit/issues/1791)

Abandoned alternative: [dunkelfrosch/phpcoverfish](https://github.com/dunkelfrosch/phpcoverfish)

Getting Started
---------------

[](#getting-started)

### Prerequisites

[](#prerequisites)

- PHP 7.1+
- PHPUnit 7.0+

### Installation

[](#installation)

#### Composer

[](#composer)

Recommended way of installing covers-validator is via [Composer](https://get.org/).

```
composer require --dev ockcyp/covers-validator
```

#### Phar

[](#phar)

Download the `covers-validator.phar` asset from the [latest release](https://github.com/oradwell/covers-validator/releases/latest)or any other release from the [releases](https://github.com/oradwell/covers-validator/releases).

Then run using the following:

```
php covers-validator.phar
```

Note

The usage documentation assumes you installed covers-validator using Composer, so please replace any reference to "vendor/bin/covers-validator" with "php covers-validator.phar".

Note

Only releases since v0.3.0 can be used as a phar.

#### Older versions

[](#older-versions)

Latest release of covers-validator supports PHP 7.1+ and PHPUnit 7+. Please use a previous release with older PHP and PHPUnit versions.

PHPUnit versionCovers-validator release< 6.00.5.x6.0 - 9.x1.57.0 - 9.x1.67.0 - 10.x>= 1.7.0### Usage

[](#usage)

Run the validator using the following:

```
vendor/bin/covers-validator
```

Tip

The command returns exit code 1 when any of the covers tags are invalid. Use this to fail your builds.

#### Override configuration file

[](#override-configuration-file)

Give optional `-c` argument to load a particular PHPUnit configuration file:

```
vendor/bin/covers-validator -c tests/Fixtures/configuration.xml
```

#### Override PHPUnit bootstrap

[](#override-phpunit-bootstrap)

Override the `bootstrap` value specified in PHPUnit configuration:

```
vendor/bin/covers-validator --bootstrap tests/bootstrap.php
```

#### Disable output

[](#disable-output)

Disable output by providing the `-q` argument

```
vendor/bin/covers-validator -q
```

Adjust the verbosity:

VerbosityShows`-v`Valid tests`-vv`Loaded configuration file`-vvv`Test name before validation is done### Sample output

[](#sample-output)

#### Normal verbosity

[](#normal-verbosity)

```
Invalid - OckCyp\CoversValidator\Tests\Fixtures\TwoTestCoveringNonExistentClassTest::testDummyTest

There were 1 test(s) with invalid @covers tags.

```

#### Maximum verbosity (debug)

[](#maximum-verbosity-debug)

```
Configuration file loaded: /home/omer/Projects/Personal/covers-validator/tests/Fixtures/configuration-all.xml

Validating OckCyp\CoversValidator\Tests\Fixtures\TwoTestCoveringExistingClassTest::testDummyTest...
Valid - OckCyp\CoversValidator\Tests\Fixtures\TwoTestCoveringExistingClassTest::testDummyTest
Validating OckCyp\CoversValidator\Tests\Fixtures\TwoTestCoveringNonExistentClassTest::testDummyTest...
Invalid - OckCyp\CoversValidator\Tests\Fixtures\TwoTestCoveringNonExistentClassTest::testDummyTest

There were 1 test(s) with invalid @covers tags.

```

Tests
-----

[](#tests)

To run the tests, execute:

```
vendor/bin/phpunit
```

Versioning
----------

[](#versioning)

We use [Semantic Versioning](https://semver.org/) for versioning. For the versions available, see the [releases](https://github.com/oradwell/covers-validator/releases) or the [CHANGELOG.md](./CHANGELOG.md) file.

Authors
-------

[](#authors)

- Oliver Radwell - [@oradwell](https://github.com/oradwell)

See also the list of [contributors](https://github.com/oradwell/covers-validator/graphs/contributors) who participated in this project.

License
-------

[](#license)

This project is licensed under the MIT License - see the [LICENSE.txt](./LICENSE.txt) file for details.

Acknowledgments
---------------

[](#acknowledgments)

- [Sebastian Bergmann](https://github.com/sebastianbergmann) for creating the [PHPUnit](https://phpunit.de/) project
- The [contributors](https://github.com/oradwell/covers-validator/graphs/contributors)

###  Health Score

56

—

FairBetter than 97% of packages

Maintenance57

Moderate activity, may be stable

Popularity44

Moderate usage in the ecosystem

Community36

Small or concentrated contributor base

Maturity78

Established project with proven stability

 Bus Factor1

Top contributor holds 86.1% of commits — single point of failure

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 ~151 days

Recently: every ~439 days

Total

25

Last Release

269d ago

Major Versions

v0.5.2 → v1.0.02018-05-08

0.5.x-dev → v1.1.02019-03-15

PHP version history (4 changes)v0.1.0PHP ^5.3.0 || ^7.0

v0.6.0PHP ^7.0

v1.3.1PHP ^7.0 || ^8.0

v1.6.0PHP ^7.1 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/e696afe1a24280bbde4071ff886394ee586eb9a33d11df0957f1c0c9cd8fd7a4?d=identicon)[ockcyp](/maintainers/ockcyp)

---

Top Contributors

[![oradwell](https://avatars.githubusercontent.com/u/5054896?v=4)](https://github.com/oradwell "oradwell (93 commits)")[![JeroenDeDauw](https://avatars.githubusercontent.com/u/146040?v=4)](https://github.com/JeroenDeDauw "JeroenDeDauw (5 commits)")[![gbirke](https://avatars.githubusercontent.com/u/223326?v=4)](https://github.com/gbirke "gbirke (2 commits)")[![Krinkle](https://avatars.githubusercontent.com/u/156867?v=4)](https://github.com/Krinkle "Krinkle (2 commits)")[![theofidry](https://avatars.githubusercontent.com/u/5175937?v=4)](https://github.com/theofidry "theofidry (2 commits)")[![mattstauffer](https://avatars.githubusercontent.com/u/151829?v=4)](https://github.com/mattstauffer "mattstauffer (1 commits)")[![jochen42](https://avatars.githubusercontent.com/u/617145?v=4)](https://github.com/jochen42 "jochen42 (1 commits)")[![smoench](https://avatars.githubusercontent.com/u/183530?v=4)](https://github.com/smoench "smoench (1 commits)")[![legoktm](https://avatars.githubusercontent.com/u/81392?v=4)](https://github.com/legoktm "legoktm (1 commits)")

---

Tags

coveragephpphp7php8phpunittestingtestingphpunitcoverage

### Embed Badge

![Health badge](/badges/ockcyp-covers-validator/health.svg)

```
[![Health](https://phpackages.com/badges/ockcyp-covers-validator/health.svg)](https://phpackages.com/packages/ockcyp-covers-validator)
```

###  Alternatives

[brianium/paratest

Parallel testing for PHP

2.5k136.1M986](/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.2k28.9M2.4k](/packages/infection-infection)[facile-it/paraunit

paraunit

145845.1k17](/packages/facile-it-paraunit)[testo/testo

A lightweight PHP testing framework.

1959.3k55](/packages/testo-testo)[robiningelbrecht/phpunit-coverage-tools

PHPUnit coverage tools

17143.1k51](/packages/robiningelbrecht-phpunit-coverage-tools)

PHPackages © 2026

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