PHP自动检测并移除UTF-8文件BOM头的方法

叶初

发布时间：2026-10-14| 2人浏览过

原创

在PHP开发中，未正确保存的UTF-8文件可能携带BOM头，导致响应数据出错。本文提供一套PHP检测工具，可遍历目录识别含BOM的文件，并根据配置参数自动剥离无效前缀。

BOM导致的常见问题

BOM（Byte Order Mark）是Unicode规范的一部分，用于标识文本编码类型。对于UTF-8，BOM表现为文件开头的隐藏字符序列 0xEF 0xBB 0xBF。虽然在某些编辑器中能辅助识别编码，但在PHP等后端环境中，它会直接混入输出流：

JSON/API响应失败： BOM作为前置字符破坏JSON结构解析。
图片生成异常： 若文件被当作图像下载，浏览器将无法识别格式。
CSS/JS失效： 头部多余的字符可能导致样式或脚本加载报错。

环境准备与核心逻辑

无需安装额外扩展，直接使用PHP内置函数即可完成处理。脚本的核心逻辑分为两步：一是读取文件前三位字节并与BOM特征比对；二是根据预设的安全策略决定仅报告还是执行清理。

第1步：编写检测与修复脚本

新建一个PHP文件（如 bom_check.php）。代码包含两个主要功能模块：主循环负责目录遍历与结果输出，核心函数 checkBOM 负责文件头判断与条件写入。

<?php
// 配置区域：修改此行为需要检测的目录，点表示当前目录
$basedir = ".";

// 是否自动移除发现的BOM信息。1为是，0为否。
// 建议初次运行设为0以预览结果
$auto = 1;

if ($dh = opendir($basedir)) {
    while (($file = readdir($dh)) !== false) {
        // 跳过当前和上级目录，且仅处理普通文件
        if ($file != '.' && $file != '..' && !is_dir($basedir . "/" . $file)) {
            echo "filename: $file " . checkBOM("$basedir/$file") . "<br>";
        }
    }
    closedir($dh);
}

function checkBOM ($filename) {
    global $auto;
    $contents = file_get_contents($filename);
    
    // 获取文件头三个字符
    $charset[1] = substr($contents, 0, 1); 
    $charset[2] = substr($contents, 1, 1); 
    $charset[3] = substr($contents, 2, 1); 
    
    // 检查是否为UTF-8 BOM (十进制对应239, 187, 191)
    if (ord($charset[1]) == 239 && ord($charset[2]) == 187 && ord($charset[3]) == 191) {
        if ($auto == 1) {
            $rest = substr($contents, 3);
            rewrite($filename, $rest);
            return "<font color=red>BOM found, automatically removed.</font>";
        } else {
            return "<font color=red>BOM found.</font>";
        }
    } 
    return "BOM Not Found.";
}

// 重写文件函数，使用写锁确保安全性
function rewrite ($filename, $data) {
    $filenum = fopen($filename, "w");
    flock($filenum, LOCK_EX);
    fwrite($filenum, $data);
    fclose($filenum);
}
?>