使用 PHP ImageFilter 类检测用户上传图片的裸露风险

小石头

发布时间：2026-10-13| 4人浏览过

原创

针对 Web 应用中用户上传的图片缺乏内容审核的问题，本文介绍了一种基于 PHP 的皮肤像素点分析方案。通过引入 ImageFilter 类库，开发者可以在服务器端对 PNG、GIF 和 JPEG 图片进行色彩分析，根据返回的风险分值判断图片是否包含不当内容，从而在上传阶段建立第一道安全防线。

解决方案概述

在处理用户上传的文件时，确保内容的合法性与安全性是 Web 开发的重要环节。一种轻量级的服务端解决方案是利用图像的色彩特征进行分析。该技术核心在于识别图片中是否存在符合人类皮肤色调的像素区域，并据此计算出一个反映裸露可能性的评分值。这种方法不需要调用大型 AI 模型，而是通过传统的图像处理逻辑实现快速筛选。

准备条件

运行环境需支持 PHP 语言环境。
需要一个经过编译或实现的 PHP 类文件（通常命名为 nf.php），该文件定义了 ImageFilter 类及其 GetScore 方法。
目标图片格式支持 PNG、GIF 和 JPEG 类型。

实现步骤

第 1 步：配置 HTML 上传表单

为了触发后端检测，首先需要一个允许用户选择文件的 HTML 表单。必须设置正确的编码类型以处理二进制文件上传。

<form method="post" enctype="multipart/form-data" action="<?php echo $SERVER['PHP_SELF']; ?> ">
Upload image: 
<input type="file" name="img" id="img" />
<input type="submit" value="Submit Image" />
</form>

注意：在实际生产中，建议指定 action 为专门的处理脚本，而非当前页面，且应添加 CSRF 防护令牌。表单中的 enctype 属性必须包含 multipart/form-data，否则文件数据无法正确传输至 $_FILES 超全局变量。

第 2 步：引入核心过滤类库

在接收上传数据的 PHP 脚本顶部，包含负责分析的类文件。这将加载 ImageFilter 类的定义，使其可供实例化。

include 'nf.php';

第 3 步：初始化过滤器并获取分值

创建 ImageFilter 类的实例，并调用其 GetScore 方法。该方法接收临时上传文件的路径作为参数，执行内部的颜色分析逻辑，并返回一个数值化的评分。

$filter = new ImageFilter;
// $_FILES['img']['tmp_name'] 指向服务器上的临时文件路径
$score = $filter->GetScore($_FILES['img']['tmp_name']);

第 4 步：根据分值判定结果

根据文档说明，该算法返回的分值反映了图片包含裸露的可能性。通常设定一个阈值（如 60%）来区分正常图片与潜在违规图片。逻辑判断流程如下：

得分 ≥ 60：系统判定为高风险，视为成人或不适宜内容。
得分 < 60：系统判定为安全，视为非裸露内容。

检查 $score 变量是否已设置。
若 $score >= 60，输出警告信息或拦截上传操作。
若 $score < 60，则视为成功通过检测，可继续后续存储流程。

完整的业务逻辑代码如下：

<?php
/* Include the Nudity Filter file */
include 'nf.php';

/* Create a new instance of the filter class */
$filter = new ImageFilter;

/* Get the analysis score from the uploaded file */
if (isset($_FILES['img'])) {
    $score = $filter->GetScore($_FILES['img']['tmp_name']);
    
    /* Evaluate the score */
    if (isset($score)) {
        if ($score >= 60) {
            // 阈值判定：疑似含有裸露内容
            echo "Image scored " . $score . "%, It seems that you have uploaded an inappropriate picture.";
        } else if ($score < 0) { // 异常情况或未检测到有效皮肤区域
            // 注：原文逻辑此处可能存在边界情况，通常得分低于阈值即视为安全
             echo "Congratulations, the image passed the basic content check.";
        } else {
             // 覆盖其他安全区间
             echo "Image scored " . $score . "%. Content considered safe.";
        }
    }
}
?>