当前位置：首页 > 文章列表 > 文章 > php教程 > PHP如何检测上传文件是否包含恶意代码_调用ClamAV扫描API进行检测

PHP如何检测上传文件是否包含恶意代码_调用ClamAV扫描API进行检测

2026-05-03 21:03:53 0浏览收藏

一分耕耘，一分收获！既然打开了这篇文章《PHP如何检测上传文件是否包含恶意代码_调用ClamAV扫描API进行检测》，就坚持看下去吧！文中内容包含等等知识点...希望你能在阅读本文后，能真真实实学到知识或者帮你解决心中的疑惑，也欢迎大佬或者新人朋友们多留言评论，多给建议！谢谢！

PHP上传文件后应通过proc_open调用clamdscan --fdpass从stdin扫描临时文件，依赖退出码判断结果：0为安全，1为感染，2为错误；需确保www-data属clamav组且clamd服务运行正常。

PHP上传文件后怎么调用ClamAV扫描？

ClamAV本身不提供HTTP API，所谓“调用ClamAV API”实际是调用其命令行工具clamdscan或clamscan，通过PHP的exec、shell_exec等函数触发。直接依赖clamd守护进程（推荐）比每次跑clamscan更高效，也避免重复加载病毒库。

关键前提是：服务器已安装并运行ClamAV，且PHP执行用户（如www-data）有权限连接clamd socket（默认/var/run/clamav/clamd.ctl）或能执行clamdscan命令。

确认clamd服务正在运行：sudo systemctl status clamav-daemon
检查socket路径是否可读写：ls -l /var/run/clamav/clamd.ctl，必要时调整clamd.conf中的LocalSocketGroup和FixStaleSocket
测试命令行能否扫描：clamdscan --fdpass /tmp/test.php（--fdpass支持从stdin传文件，适合临时上传文件）

如何安全地把上传文件交给clamdscan而不落盘？

上传文件先存到$_FILES['file']['tmp_name']，这是PHP自动分配的临时路径。你不该把它移动到Web可访问目录再扫描——这会留出时间窗口被利用。理想做法是：直接用clamdscan --fdpass把临时文件句柄传给clamd，全程不写磁盘、不改权限、不暴露路径。

示例代码片段：

$tmpFile = $_FILES['file']['tmp_name'];
$descriptors = [
    0 => ['pipe', 'r'],
    1 => ['pipe', 'w'],
    2 => STDERR
];
$proc = proc_open('clamdscan --fdpass --no-summary -', $descriptors, $pipes);
if (is_resource($proc)) {
    fwrite($pipes[0], file_get_contents($tmpFile));
    fclose($pipes[0]);
    $output = stream_get_contents($pipes[1]);
    fclose($pipes[1]);
    $returnCode = proc_close($proc);
    if ($returnCode === 1) {
        // 检出恶意代码
    } elseif ($returnCode === 0) {
        // 清洁
    }
}

--fdpass是关键，它让clamd从stdin读取原始字节，跳过文件系统路径校验
不要用exec("clamdscan $tmpFile")——路径可能含空格或特殊字符，且/tmp下文件名不可信
--no-summary减少输出干扰；-表示从stdin读

扫描返回结果怎么判断是否含恶意代码？

clamdscan退出码（exit code）比stdout文本更可靠：

退出码 0：未发现威胁（clean）
退出码 1：发现威胁（infected）
退出码 2：扫描出错（如权限不足、socket连不上、文件损坏）

stdout里可能含类似/dev/stdin: PHP.Trojan.Spambot-1 FOUND的行，但格式不稳定（尤其多语言环境），不应正则匹配。只依赖退出码做逻辑分支，错误时记录$output和$returnCode用于排查。

注意：clamscan（非守护进程版）退出码含义相同，但性能差、启动慢、易超时，不建议在Web请求中使用。

为什么扫描有时失败或超时？常见权限与配置坑

最常卡在三处：socket权限、SELinux/AppArmor、PHP禁用函数。

PHP用户（如www-data）必须属于clamav组，否则无法connect到/var/run/clamav/clamd.ctl —— 运行sudo usermod -a -G clamav www-data并重启PHP-FPM
SELinux启用时，默认禁止httpd_t域访问clamd_t socket，需自定义策略或临时设为permissive：sudo setsebool -P httpd_can_network_connect 1
检查disable_functions是否禁用了proc_open、exec等 —— 在phpinfo()里搜disable_functions确认
clamd默认限制单次扫描文件大小（StreamMaxLength，默认25MB），大文件会直接拒绝，需在/etc/clamav/clamd.conf里调高并重启服务