PHPackages                             polozpavlo/allure-phpunit - 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. polozpavlo/allure-phpunit

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

polozpavlo/allure-phpunit
=========================

A PHPUnit adapter for Allure report.

1.2.3(8y ago)05.0kApache-2.0PHPPHP >=7.0.0

Since May 4Pushed 6y agoCompare

[ Source](https://github.com/polozpavlo/allure-phpunit)[ Packagist](https://packagist.org/packages/polozpavlo/allure-phpunit)[ Docs](http://allure.qatools.ru/)[ RSS](/packages/polozpavlo-allure-phpunit/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (3)Versions (14)Used By (0)

Allure PHPUnit adapter
======================

[](#allure-phpunit-adapter)

This an official PHPUnit adapter for Allure Framework - a flexible, lightweight and multi-language framework for writing self-documenting tests.

Table of Contents
-----------------

[](#table-of-contents)

- [What is this for?](#what-is-this-for)
- [Example Project](#example-project)
- [How to Generate Report](#how-to-generate-report)
- [Installation and Usage](#installation-and-usage)
- [Main Features](#main-features)
    - [Title](#human-readable-test-class-or-test-method-title)
    - [Description](#extended-test-class-or-test-method-description)
    - [Test severity](#set-test-severity)
    - [Test parameters](#specify-test-parameters-information)
    - [Features and Stories](#map-test-classes-and-test-methods-to-features-and-stories)
    - [Attachments](#attach-files-to-report)
    - [Steps](#divide-test-methods-into-steps)

What is this for?
-----------------

[](#what-is-this-for)

The main purpose of this adapter is to accumulate information about your tests and write it out to a set of XML files: one for each test class. Then you can use a standalone command line tool or a plugin for popular continuous integration systems to generate an HTML page showing your tests in a good form.

Example project
---------------

[](#example-project)

Example project is located at:

How to generate report
----------------------

[](#how-to-generate-report)

This adapter only generates XML files containing information about tests. See [wiki section](https://github.com/allure-framework/allure-core/wiki#generating-report) on how to generate report.

Installation && Usage
-----------------------------

[](#installation--usage)

**Note:** this adapter supports Allure 1.4.x only. In order to use this adapter you need to add a new dependency to your **composer.json** file:

```
{
    "require": {
	    "php": ">=7.0.0",
	    "allure-framework/allure-phpunit": "~1.2.0"
    }
}

```

Then add Allure test listener in **phpunit.xml** file:

```

            build/allure-results
            true

                    someCustomAnnotation

```

After running PHPUnit tests a new folder will be created (**build/allure-results** in the example above). This folder will contain generated XML files. See [framework help](https://github.com/allure-framework/allure-core/wiki) for details about how to generate report from XML files. By default generated report will only show a limited set of information but you can use cool Allure features by adding a minimum of test code changes. Read next section for details.

Main features
-------------

[](#main-features)

This adapter comes with a set of PHP annotations and traits allowing to use main Allure features.

### Human-readable test class or test method title

[](#human-readable-test-class-or-test-method-title)

In order to add such title to any test class or [test case](https://github.com/allure-framework/allure-core/wiki/Glossary#test-case) method you need to annotate it with **@Title** annotation:

```
namespace Example\Tests;

use PHPUnit\Framework\TestCase;
use Yandex\Allure\Adapter\Annotation\Title;

/**
 * @Title("Human-readable test class title")
 */
class SomeTest extends TestCase
{
    /**
     * @Title("Human-readable test method title")
     */
    public function testCase()
    {
        //Some implementation here...
    }
}
```

### Extended test class or test method description

[](#extended-test-class-or-test-method-description)

Similarly you can add detailed description for each test class and [test method](https://github.com/allure-framework/allure-core/wiki/Glossary#test-case). To add such description simply use **@Description** annotation:

```
namespace Example\Tests;

use PHPUnit\Framework\TestCase;
use Yandex\Allure\Adapter\Annotation\Description;
use Yandex\Allure\Adapter\Model\DescriptionType;

/**
 * @Description("Detailed description for test class")
 */
class SomeTest extends TestCase
{
    /**
     * @Description(value = "Detailed description for test class.", type = DescriptionType::HTML)
     */
    public function testCase()
    {
        //Some implementation here...
    }
}
```

Description can be added in plain text, HTML or Markdown format - simply assign different **type** value.

### Set test severity

[](#set-test-severity)

**@Severity** annotation is used in order to prioritize test methods by severity:

```
namespace Example\Tests;

use PHPUnit\Framework\TestCase;
use Yandex\Allure\Adapter\Annotation\Severity;
use Yandex\Allure\Adapter\Model\SeverityLevel;

class SomeTest extends TestCase
{
    /**
     * @Severity(level = SeverityLevel::MINOR)
     */
    public function testCase()
    {
        //Some implementation here...
    }
}
```

### Specify test parameters information

[](#specify-test-parameters-information)

In order to add information about test method [parameters](https://github.com/allure-framework/allure-core/wiki/Glossary#parameter) you should use **@Parameter** annotation:

```
namespace Example\Tests;

use PHPUnit\Framework\TestCase;
use Yandex\Allure\Adapter\Annotation\Parameter;
use Yandex\Allure\Adapter\Model\ParameterKind;

class SomeTest extends TestCase
{
    /**
     * @Parameter(name = "param1", value = "value1")
     * @Parameter(name = "param2", value = "value2", kind = ParameterKind::SYSTEM_PROPERTY)
     */
    public function testCase()
    {
        //Some implementation here...
    }
}
```

### Map test classes and test methods to features and stories

[](#map-test-classes-and-test-methods-to-features-and-stories)

In some development approaches tests are classified by [stories](https://github.com/allure-framework/allure-core/wiki/Glossary#user-story) and [features](https://github.com/allure-framework/allure-core/wiki/Glossary#feature). If you're using this then you can annotate your test with **@Stories** and **@Features** annotations:

```
namespace Example\Tests;

use PHPUnit\Framework\TestCase;
use Yandex\Allure\Adapter\Annotation\Features;
use Yandex\Allure\Adapter\Annotation\Stories;

/**
 * @Stories({"story1", "story2"})
 * @Features({"feature1", "feature2", "feature3"})
 */
class SomeTest extends TestCase
{
    /**
     * @Features({"feature2"})
     * @Stories({"story1"})
     */
    public function testCase()
    {
        //Some implementation here...
    }
}
```

You will then be able to filter tests by specified features and stories in generated Allure report.

### Attach files to report

[](#attach-files-to-report)

If you wish to [attach some files](https://github.com/allure-framework/allure-core/wiki/Glossary#attachment) generated during PHPUnit run (screenshots, log files, dumps and so on) to report - then you need to use **AttachmentSupport** trait in your test class:

```
namespace Example\Tests;

use PHPUnit\Framework\TestCase;
use Yandex\Allure\Adapter\Support\AttachmentSupport;

class SomeTest extends TestCase
{

    use AttachmentSupport;

    public function testCase()
    {
        //Some implementation here...
        $filePath = $this->outputSomeContentToTemporaryFile();
        $this->addAttachment($filePath, 'Attachment human-readable name', 'text/plain');
        //Some implementation here...
    }

    private function outputSomeContentToTemporaryFile()
    {
        $tmpPath = tempnam(sys_get_temp_dir(), 'test');
        file_put_contents($tmpPath, 'Some content to be outputted to temporary file.');
        return $tmpPath;
    }

}
```

In order to create an [attachment](https://github.com/allure-framework/allure-core/wiki/Glossary#attachment) simply call **AttachmentSupport::addAttachment()** method. This method accepts attachment type, human-readable name and a string either storing full path to the file we need to attach or file contents.

### Divide test methods into steps

[](#divide-test-methods-into-steps)

Allure framework also supports very useful feature called [steps](https://github.com/allure-framework/allure-core/wiki/Glossary#test-step). Consider a test method which has complex logic inside and several assertions. When an exception is thrown or one of assertions fails sometimes it's very difficult to determine which one caused the failure. Allure steps allow to divide test method logic into several isolated pieces having independent run statuses such as **passed** or **failed**. This allows to have much more cleaner understanding of what really happens. In order to use steps simply import **StepSupport** trait in your test class:

```
namespace Example\Tests;

use PHPUnit\Framework\TestCase;
use Yandex\Allure\Adapter\Support\StepSupport;

class SomeTest extends TestCase
{

    use StepSupport;

    public function testCase()
    {
        //Some implementation here...
        $this->executeStep("This is step one", function () {
            $this->stepOne();
        });

        $this->executeStep("This is step two", function () {
            $this-stepTwo();
        });

        $this->executeStep("This is step three", function () {
            $this->stepThree('someArgument');
        });
        //Some implementation here...
    }

    private function stepOne()
    {
        //Some implementation here...
    }

    private function stepTwo()
    {
        //Some implementation here...
    }

    private function stepThree($argument)
    {
        //Some implementation here...
    }

}
```

The entire test method execution status will depend on every step but information about steps status will be stored separately.

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 66.2% 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 ~142 days

Recently: every ~293 days

Total

10

Last Release

3111d ago

PHP version history (2 changes)1.0.0PHP >=5.4.0

1.2.3PHP >=7.0.0

### Community

Maintainers

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

---

Top Contributors

[![vania-pooh](https://avatars.githubusercontent.com/u/829320?v=4)](https://github.com/vania-pooh "vania-pooh (45 commits)")[![robot-bucket](https://avatars.githubusercontent.com/u/135020565?v=4)](https://github.com/robot-bucket "robot-bucket (7 commits)")[![polozpavlo](https://avatars.githubusercontent.com/u/18253561?v=4)](https://github.com/polozpavlo "polozpavlo (5 commits)")[![tyz910](https://avatars.githubusercontent.com/u/1503703?v=4)](https://github.com/tyz910 "tyz910 (4 commits)")[![OndraM](https://avatars.githubusercontent.com/u/793041?v=4)](https://github.com/OndraM "OndraM (4 commits)")[![popstas](https://avatars.githubusercontent.com/u/3027126?v=4)](https://github.com/popstas "popstas (1 commits)")[![crowdintest1](https://avatars.githubusercontent.com/u/19567994?v=4)](https://github.com/crowdintest1 "crowdintest1 (1 commits)")[![tvanrijn](https://avatars.githubusercontent.com/u/12894463?v=4)](https://github.com/tvanrijn "tvanrijn (1 commits)")

---

Tags

testingphpunitreportattachmentsallurestepscases

### Embed Badge

![Health badge](/badges/polozpavlo-allure-phpunit/health.svg)

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

###  Alternatives

[allure-framework/allure-phpunit

Allure PHPUnit integration

6612.8M36](/packages/allure-framework-allure-phpunit)[allure-framework/allure-codeception

Allure Codeception integration

5212.1M7](/packages/allure-framework-allure-codeception)[brianium/paratest

Parallel testing for PHP

2.5k118.8M754](/packages/brianium-paratest)[spatie/phpunit-snapshot-assertions

Snapshot testing with PHPUnit

69417.9M511](/packages/spatie-phpunit-snapshot-assertions)[phpunit/phpunit-selenium

Selenium Server integration for PHPUnit

59610.9M150](/packages/phpunit-phpunit-selenium)[yoast/phpunit-polyfills

Set of polyfills for changed PHPUnit functionality to allow for creating PHPUnit cross-version compatible tests

18338.5M841](/packages/yoast-phpunit-polyfills)

PHPackages © 2026

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