Skip to content
PHPUnit matcher/assertions for GD image resources
PHP
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src
tests
.gitattributes
.gitignore
.phpmdRulesets.xml
.phpunit.xml
.phpunit53.xml
.travis.yml
LICENSE
README.md
composer.json

README.md

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.

Compatibility note: This library supports PHP versions 5.3.3 up to 7.2.2. It supports PHPUnit from version 4.8.36 to version 6.5.0. Since those PHPUnit versions are completely incompatible, extreme hacks have to be used that depend on the Composer autoloading order. Please file an issue if you notice any errors.

Installation

Add this package to your Composer dev-dependencies:

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

Examples

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

<?php
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');
    }
}

Note: While this library should work with PHP down to at least v5.3.3, traits are a v5.4.0 feature. For versions lower than v5.4.0, you have to use this alternative syntax:

<?php
use AssertGD\GDSimilarityConstraint;

class ExampleTest extends PHPUnit_Framework_TestCase
{
    public function testSomething()
    {
        $this->assertThat('./tests/actual.png',
            new GDSimilarityConstraint('./tests/expected.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);
imagedestroy($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.).

$this->assertThat(
    './tests/actual.png',
    $this->isSimilarGD('./tests/expected.png')
);
You can’t perform that action at this time.