travail/image-perceptualhash

travail/image-perceptualhash

Image\PerceptualHash

NAME

Image\PerceptualHash - Generate comparable hash from images, _(*1)

SYNOPSIS

<?php

use Image\PerceptualHash;
use Image\PerceptualHash\Algorithm\DifferenceHash;
use Image\PerceptualHash\Algorithm\PerceptionHash;

// Create an instance of Image\PerceptualHash, at the same time calculate hashes
// using hashing algorithm Image\PerceptualHash\Algorithm\AverageHash by default
$ph = new PerceptualHash('/path/to/foo.jpg');

// Get binary hash
$binary_hash = $ph->bin();

// Get hexadecimal hash
$hex_hash = $ph->hex();

// Compare with another image, return a Hamming distance
$distance = $ph->compare('/path/to/bar.jpg');

// Calculate a similarity
$similarity = $ph->similarity('/path/to/baz.jpg');

// Calculate by other hashing algorithms
$ph = new PerceptualHash('/path/to/foo.jpg', new DifferenceHash());
// or
$ph = new PerceptualHash('/path/to/foo.jpg', new PerceptionHash());

DESCRIPTION

Image\PerceptualHash generates distinct, but not unique fingerprint with three hashing algorithms. Unlike cryptographic hashing, these fingerprints from similar images will be also similar., _(*2)

DEPENDENCIES

• ext-gd

INSTALLATION

To install this package into your project via composer, add the following snippet to your composer.json. Then run composer install., _(*3)

"require": {
  "travail/image-perceptualhash": "dev-master"
}

or, _(*4)

"repositories": {
  {
    "type": "vcs",
    "url": "git@github.com:travail/php-Image-PerceptualHash.git"
  }
}

TESTS

After cloning the project, run composer install and ./vendor/bin/phpunit., _(*5)

$ git clone git@github.com:travail/php-Image-PerceptualHash.git
$ cd php-Image-PerceptualHash
$ composer install
$ ./vendor/bin/phpunit

METHODS

__construct

Image\PerceptualHash __construct($file, Algorithm $algorithm)

Creates a new instance of Image\PerceptualHash and calculates hashes., _(*6)

$file

Path to a file or a resource of that., _(*7)

Algorithm $algorithm

Hashing algorithm, currently the following algorithm are available:, _(*8)

• AverageHash
• DifferenceHash
• PerceptionHash

bin

string bin()

Returns calculated binary hash., _(*9)

hex

string hex()

Returns calculated hexadecimal hash., _(*10)

compare

int compare(string|resource $file)

Compares with another image and returns the Hamming distance to that., _(*11)

$file

Path to a file or a resource of that., _(*12)

distance

int distance(string $hash1, string $hash2)

similarity

double similarity(string|resource $file)

Calcuates the similarity to another image., _(*13)

$file

Path to a file or a resource of that., _(*14)

AUTHOR

travail, _(*15)

LICENSE

This library is free software. You can redistribute it and/or modify it under the same terms as PHP itself., _(*16)