应使用phash或ahash等感知哈希而非MD5：前者提取图像结构特征生成64位二进制指纹，相似图汉明距离小；推荐jiandong/imagehash包，需启用GD扩展并注意WebP兼容性处理。

PHP用imagehash生成感知哈希值，别直接用MD5

MD5等传统哈希对图片缩放、旋转、加水印后就失效，根本没法识别视觉重复图。感知哈希（如phash、ahash）才是正解——它提取图像结构特征，生成64位二进制指纹，相似图哈希值汉明距离小。
推荐用jiandong/imagehash Composer包（轻量、纯PHP、无OpenCV依赖）：

composer require jiandong/imagehash

注意：GD扩展必须启用，且imagecreatefromjpeg等函数要能读取你的图片格式（PNG/JPEG/WebP需对应支持）。

phash比ahash更抗缩放，但计算慢一点

两种算法核心区别在预处理：ahash只做缩放+灰度+均值阈值，快但对尺寸变化敏感；phash多一步DCT变换，保留低频能量分布，缩略图/裁剪后仍稳定。
实操建议：

• 秒传场景优先用phash，尤其用户上传尺寸不一的手机截图
• 批量校验老图库可用ahash快速筛一遍，再对候选集用phash精判
• 哈希值统一转为bindec()后的十进制整数存数据库，方便用BIGINT索引
• 汉明距离阈值设为≤5（64位中最多5位不同），实测误判率低于0.3%

哈希值入库前必须去重+加索引，否则查不动

直接按哈希值查表？没索引时10万张图可能要3秒以上。关键动作：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• 数据库字段类型用BIGINT UNSIGNED存哈希整数，别用VARCHAR
• 给哈希列建INDEX（不是UNIQUE！因不同图可能偶然碰撞）
• 插入前先SELECT COUNT(*) WHERE hash = ?，有记录则跳过存储，返回已有URL
• 如果用Redis缓存热点哈希，key设为img:hash:{phash_value}，TTL建议30分钟，避免内存暴涨

漏掉索引或用字符串存哈希，上线后查重接口会直接拖垮DB。

WebP格式图片要先转JPEG再哈希，GD默认不支持WebP读取

PHP 8.1+虽原生支持imagecreatefromwebp，但很多生产环境GD编译时没开WebP支持（gd_info()['WebP Support'] === false）。强行调用会报Unsupported image type错误。
稳妥做法：

• 用getimagesize($path)拿到mime，是image/webp就先用exec('convert '.$path.' -quality 85 '.$tmp_jpg)转JPEG（需ImageMagick）
• 或者用file_get_contents读WebP二进制，交由jiandong/imagehash内部的imagecreatefromstring处理（该库已兼容WebP）
• 千万别用base64_decode后直接喂给GD函数——二进制损坏会导致imagecreatefromstring(): Empty string or invalid image

WebP路径判断和转换逻辑，必须放在哈希计算前，否则整个流程卡死。

立即学习“PHP免费学习笔记（深入）”；