lujihong/image-hash

PHP的感知图像哈希

维护者

详细信息

github.com/lujihong/image-hash

主页

源代码

问题

安装: 10

依赖: 0

建议: 0

安全: 0

星标: 1

关注者: 1

分支: 0

开放问题: 0

v0.7.0 2021-06-13 16:52 UTC

Requires

Requires (Dev)

Suggests

  • ext-gd: GD or ImageMagick is required
  • ext-gmp: GMP results in faster comparisons
  • ext-imagick: GD or ImageMagick is required

MIT d7b5757c8fb5367b88dbacf2b28e2af68c72f026

hashimagehashperceptualdhashahashphashimage hash

This package is auto-updated.

Last update: 2024-09-13 23:58:32 UTC

README

感知哈希是从多媒体文件内容的各种特征中派生出来的指纹。与依赖于输入微小变化导致输出剧烈变化的密码哈希函数不同，如果特征相似，感知哈希则彼此“接近”。

感知哈希与MD5和SHA1等密码哈希函数是不同的概念。在密码哈希中，哈希值是随机的。用于生成哈希的数据就像一个随机种子，所以相同的数据将生成相同的结果，但不同的数据将产生不同的结果。比较两个SHA1哈希值实际上只能告诉你两件事。如果哈希值不同，则数据不同。如果哈希值相同，则数据很可能相同。相比之下，感知哈希可以进行比较——给出两个数据集之间相似性的感觉。

此代码受到以下启发/基于以下内容

要求

  • PHP 7.1或更高版本
  • 需要安装gd或imagick扩展
  • 可选，安装GMP扩展以加快指纹比较速度

安装

此包尚未达到稳定版本，0.x版本之间可能存在向后不兼容。如果您打算在生产中使用，请务必锁定您的版本！

使用composer安装

composer require lujihong/image-hash

用法

此库包含4种内置哈希实现

  • Lujihong\ImageHash\Implementations\AverageHash - 基于平均图像颜色的哈希
  • Lujihong\ImageHash\Implementations\DifferenceHash - 基于前一个像素的哈希
  • Lujihong\ImageHash\Implementations\BlockHash - 基于blockhash.io的哈希 仍在开发中
  • Lujihong\ImageHash\Implementations\PerceptualHash - 原始pHash 仍在开发中

选择这些实现之一。如果您不知道该使用哪一个，请尝试DifferenceHash实现。某些实现允许一些配置，请务必检查构造函数。

use Lujihong\ImageHash\ImageHash;
use Lujihong\ImageHash\Implementations\DifferenceHash;

$hasher = new ImageHash(new DifferenceHash());
$hash = $hasher->hash('path/to/image.jpg');

echo $hash;
// or
echo $hash->toHex();

生成的Hash对象是一个十六进制图像指纹，一旦计算就可以存储在您的数据库中。汉明距离用于比较两个图像指纹的相似性。低距离值表示图像相似或相同，高距离值表示图像不同。使用以下方法检测图像是否相似：

$distance = $hasher->distance($hash1, $hash2);
// or
$distance = $hash1->distance($hash2);

相同的图像不总是具有距离为0，因此您需要决定在哪个距离上评估图像为相同。对于我测试的图像集，最大距离为5是可以接受的。但这也将取决于实现、图像和图像数量。例如；当比较少量图像时，应接受较低的公差，因为假阳性的可能性很低。但是，如果您正在比较大量图像，5可能已经太多。

Hash对象可以以几种不同的格式返回内部二进制哈希

echo $hash->toHex(); // 7878787c7c707c3c
echo $hash->toBin(); // 0111100001111000011110000111110001111100011100000111110000111100
echo $hash->toInt(); // 8680820757815655484
echo $hash->toBytes(); // "\x0F\x07ƒƒ\x03\x0F\x07\x00"

请选择您在数据库中存储哈希值的首选项。如果您想从一个之前计算出的值中重建一个 Hash 对象，请使用

$hash = Hash::fromHex('7878787c7c707c3c');
$hash = Hash::fromBin('0111100001111000011110000111110001111100011100000111110000111100');
$hash = Hash::fromInt('8680820757815655484');

示例

这些图像相似

Equals1 Equals2

Image 1 hash: 3c3e0e1a3a1e1e1e (0011110000111110000011100001101000111010000111100001111000011110)
Image 2 hash: 3c3e0e3e3e1e1e1e (0011110000111110000011100011111000111110000111100001111000011110)
Hamming distance: 3

这些图像不同

Equals1 Equals2

Image 1 hash: 69684858535b7575 (0010100010101000101010001010100010101011001010110101011100110111)
Image 2 hash: e1e1e2a7bbaf6faf (0111000011110000111100101101001101011011011101010011010101001111)
Hamming distance: 32