如何在 PHP 中实现基于感知哈希的图像相似度匹配-php教程-PHP中文网

如何在 PHP 中实现基于感知哈希的图像相似度匹配

本文介绍如何用 php 实现用户上传图片后，自动比对目录中所有图片并返回视觉相似（非完全相同）的结果，替代传统 md5 精确匹配，核心采用感知哈希（phash）算法提升鲁棒性。

本文介绍如何用 php 实现用户上传图片后，自动比对目录中所有图片并返回视觉相似（非完全相同）的结果，替代传统 md5 精确匹配，核心采用感知哈希（phash）算法提升鲁棒性。

在图像检索场景中，仅依赖 MD5 或 SHA-1 进行文件级哈希比对，只能识别字节完全一致的副本（如未修改的原始文件），无法应对常见的视觉相似情况：缩放、轻微裁剪、格式转换（JPG ↔ PNG）、亮度/对比度微调、水印添加等。此时需引入感知哈希（Perceptual Hashing）——它将图像内容抽象为紧凑的哈希值，使视觉相近的图像生成汉明距离（Hamming Distance）较小的哈希码。

推荐使用轻量、开源的 compareImages 类（源自 nvthaovn/CompareImage），其底层基于经典的 pHash 算法：先将图像灰度化、缩放至 32×32，再经离散余弦变换（DCT），保留低频系数，最后通过中值量化生成 64 位二进制指纹。两图哈希值间的汉明距离越小，视觉相似度越高。

✅ 完整可运行示例

首先，下载 compareImages.php 并置于项目根目录（或调整 include 路径）：

<?php // compareImages.php 已封装好 pHash 计算与汉明距离逻辑
include('compareImages.php');

if (isset($_POST['submit'])) {
    // 1. 安全处理上传文件
    $file = $_FILES['file'];
    if ($file['error'] !== UPLOAD_ERR_OK) {
        die("文件上传失败：" . $file['error']);
    }

    $ext = strtolower(pathinfo($file['name'], PATHINFO_EXTENSION));
    if (!in_array($ext, ['jpg', 'jpeg', 'png', 'gif'])) {
        die("仅支持 JPG、PNG、GIF 格式");
    }

    $iname = date('His') . '.' . $ext;
    $uploadPath = 'upload/' . $iname;

    // 创建 upload 目录（若不存在）
    if (!is_dir('upload')) mkdir('upload', 0755, true);

    if (!move_uploaded_file($file['tmp_name'], $uploadPath)) {
        die("文件保存失败");
    }

    // 2. 初始化比对器（自动计算上传图的 pHash）
    $comparator = new compareImages($uploadPath);

    // 3. 扫描目标图库（建议限定格式，避免读取隐藏文件）
    $targetImages = glob('img/*.{jpg,jpeg,png,gif}', GLOB_BRACE);

    echo "<h3>相似图片结果（汉明距离 ";
    $results = [];

    foreach ($targetImages as $imgPath) {
        $distance = $comparator->compareWith($imgPath);
        // 阈值说明：0=完全相同；≤10 高度相似；≤21 通常可接受为“相似”；>30 基本无关
        if ($distance  $imgPath,
                'distance' => $distance
            ];
            echo "@@##@@";
        }
    }

    if (empty($results)) {
        echo "<p>未找到视觉相似的图片。</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站"><img
														src="https://img.php.cn/upload/skill/000/000/081/179040786932301.jpg" alt="btpanel phpsite 宝塔面板PHP网站" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站" class="overflowclass">btpanel phpsite 宝塔面板PHP网站</a>
													<p class="overflowclass">宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理</p>
												</div>
												<a rel="nofollow" href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div>";
    }
}
?>

配套 HTML 表单（增强用户体验）：


<title>图像相似度搜索</title><h2>上传图片查找相似项</h2>

您上传的图片：

@@##@@" width="120" height="120" style="border:1px solid #ccc;">

⚠️ 关键注意事项

性能优化：glob('img/*') 在图片量大（>500 张）时会变慢。生产环境建议：
- 预先计算并缓存所有图库图像的 pHash 到数据库（如 MySQL JSON 字段或 Redis）；
- 使用异步队列（如 Redis + Worker）处理批量比对。
阈值调优：$diff
更严格（如
更宽松（如

安全性加固：