PHP finfo_buffer 怎样识别内存字符串的 MIME 类型

如果文件内容已经在 PHP 字符串里，不必先写入临时文件再判断类型。finfo::buffer() 会直接读取这段二进制数据，并返回 MIME 类型字符串；需要给程序做分支判断时，优先使用 FILEINFO_MIME_TYPE，因为它返回的是不带编码后缀的纯类型，例如 image/png。

官方地址：https://www.php.net/manual/en/function.finfo-buffer.php

需要注意的是，MIME 识别是输入判断信号，不等于“文件一定安全”或“内容一定可以按该类型解析”。下面把对象、标志、错误和业务边界拆开。

finfo_buffer 识别的对象是什么

finfo_buffer() 的参数是已经拿到内存中的字符串，适合处理上传内容、HTTP 响应体或消息队列中的二进制字段。它和 finfo_file() 的区别是：后者接收文件路径，前者不要求先落盘。

官方手册把返回值定义为 string|false。常见的两个标志可以这样理解：

如果下游只比较完整类型，使用 FILEINFO_MIME_TYPE 更不容易把编码后缀误当成类型的一部分。

用 finfo::buffer 读取内存中的二进制内容

下面的例子假设 $buffer 已经是消息体或上传内容。示例只演示识别动作，不把识别结果直接当成最终放行决定。

buffer($buffer);

// false 表示识别失败，不能和字符串结果混在一起处理。
if ($mime === false) {
    throw new RuntimeException('无法识别内存内容的 MIME 类型');
}

echo $mime, PHP_EOL;
?>

这里有三个关键点。第一，new finfo(FILEINFO_MIME_TYPE) 把输出格式固定为纯类型；第二，使用 === false 判断失败，避免宽松判断把空字符串或其他可转为假的值混在一起；第三，输入是字符串，不需要为了调用 buffer() 额外制造临时路径。

为什么不要把 false 当成通用 MIME

识别失败时，函数返回的是 false，不是一个可以放心替代的通用类型。把失败统一改写成 application/octet-stream 虽然方便继续流转，却会掩盖扩展缺失、数据截断或内容本身无法识别的问题。

buffer($buffer);

// 先处理识别失败，再判断是否属于业务允许列表。
if ($mime === false) {
    $decision = 'reject: mime detection failed';
} elseif (!in_array($mime, $allowed, true)) {
    $decision = 'reject: mime type is not allowed';
} else {
    $decision = 'continue: pass to size and parser checks';
}

echo $decision, PHP_EOL;
?>

如果运行环境没有启用 fileinfo，创建检测器或调用检测方法可能失败，因此部署时应把扩展状态当作运行前提处理。文章不把这个前提改造成静默兜底，否则线上会出现“类型未知但仍按图片处理”的错觉。

把 MIME 结果接入业务时要保留哪些边界

识别结果适合做第一层路由，但至少还要保留三类判断：

• 大小边界：先限制内存字符串的长度，避免对超大输入直接做缓冲区识别。
• 业务允许列表：用明确的 MIME 集合表达产品真正支持的类型，并使用严格比较。
• 实际解析：图片、PDF 等内容仍要交给对应解析器检查结构；扩展名和 MIME 都不能代替解析。

同时要记住，finfo_buffer 依据二进制特征做判断，不能把它当成用户声明的 Content-Type 的简单回显。日志中可以保留原始声明与检测结果的差异，业务分支则应以服务器实际读取到的内容为准。

常见问题

FILEINFO_MIME_TYPE 和 FILEINFO_MIME 怎么选？

需要和白名单比较时选 FILEINFO_MIME_TYPE；需要同时记录编码信息时才考虑 FILEINFO_MIME。两者的返回字符串格式不同，不能混用同一组精确比较。

finfo::buffer 能代替文件扩展名判断吗？

它比扩展名更接近实际内容，但仍只是识别信号。生产流程还应加入大小限制、允许列表和针对目标格式的解析检查。

为什么识别结果是 false？

优先检查 fileinfo 扩展是否可用、输入是否为空或截断、检测器是否成功创建，并把 false 单独记录为识别失败，不要直接改成一个看似正常的默认类型。

小结：对内存中的二进制字符串，创建 finfo(FILEINFO_MIME_TYPE) 后调用 buffer() 就能得到适合程序判断的 MIME 类型。先用严格比较处理 false，再把结果交给大小、白名单和实际解析等后续边界，流程会比只看扩展名或只信请求头更可靠。