Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

AssertGD for PHPUnit

Build Status

Trying to assert images with PHPUnit? This project provides a constraint and the required assertions that allow you do to so.

It supports comparing files on disk as well as image resources in memory.


Add this package to your Composer dev-dependencies:

composer require --dev meyfa/phpunit-assert-gd

Compatibility table

AssertGD version Supported PHP version Supported PHPUnit version
3.* >= 7.3 9
2.* >= 7.2 8
1.* >= 5.3.3 4.8.36 - 6.5.0


The assertions are available as a trait, so you can easily use them in your test case class:

use AssertGD\GDAssertTrait;

class ExampleTest extends PHPUnit\Framework\TestCase
    // this trait adds the assert methods to your test case
    use GDAssertTrait;

    public function testSomething()
        $this->assertSimilarGD('./tests/expected.png', './tests/actual.png');

Plain comparisons

Use assertSimilarGD if you expect 2 images to be exactly equal. Use assertNotSimilarGD if you expect there to be differences.

$this->assertSimilarGD('./tests/img.png', './tests/same.png');
$this->assertNotSimilarGD('./tests/img.png', './tests/other.png');

Threshold values

Provide a number between 0 and 1 to set the error threshold. For example, a value of 0.2 would allow for at most 20% difference.

$this->assertSimilarGD('./tests/img.png', './tests/similar.png', '', 0.2);

Parameter types

Instead of file paths, you can pass in GD image resources. This eliminates having to write something to disk prior to the comparison.

$img = imagecreatetruecolor(10, 10);
$this->assertSimilarGD('./tests/empty-10x10.png', $img);

Manual constraint

If you need to configure mock objects or do other, more complex matching calls, use isSimilarGD to obtain a constraint object (similar to what would be returned by equalTo, isTrue, etc.).