如何在PHP目录搜索时检测并移除文件名中的BOM

我有大约220个文件名开头带有BOM（URL编码为%EF%BB%BF）的PHP文件，示例文件名对应链接为https://www.dme.net/Pages/%EF%BB%BFPLATE-PULLER-.php，这类文件名显得不专业。我尝试扫描目录并移除该BOM，但PHP搜索无法识别%EF%BB%BF，用scandir获取文件名时看不到该标识，现有代码中的str_replace替换无效。

现有代码示例：

<?php 
$directory = getcwd();
$directory = $directory."/";
$phpfiles = scandir($directory);

foreach($phpfiles as $phpfile) 
{
    echo "<p>phpfile is ".$phpfile."</p>";
    if($phpfile != "/RenameBadFiles10.php")
    {
          echo "<p>".$phpfile."</p>";
          echo "<br>";
          $new_name = str_replace("%EF%BB%B","",$phpfile);
          
          $FullOldFileName = $directory."".$phpfile;
          $FullNewFileName = $directory."".$new_name;
        
        // using rename() function to rename the file
        rename($FullOldFileName, $FullNewFileName);

        echo $FullOldFileName." renamed to ".$FullNewFileName;
    }
}
?>

请问如何在PHP目录搜索时检测并移除文件名中的BOM？

核心问题在于：文件名中的BOM是原始字节序列\xEF\xBB\xBF，而非URL编码后的字符串%EF%BB%BF，所以用str_replace替换URL编码字符串完全无效。以下是修正后的实现方案：

关键要点 #

• 直接使用UTF-8 BOM的原始字节序列"\xEF\xBB\xBF"来检测和替换
• 过滤目录中的.和..，避免误操作
• 仅处理PHP文件（可选，按需求调整）
• 增加错误处理，避免批量操作失败无提示

修正后的代码 #

<?php
$directory = getcwd();
// 定义UTF-8 BOM的原始字节序列
$bom = "\xEF\xBB\xBF";
// 获取目录下所有条目，过滤掉.和..
$files = array_filter(scandir($directory), function($item) {
    return !in_array($item, ['.', '..']);
});

foreach ($files as $file) {
    // 跳过当前执行的脚本文件
    if ($file === basename(__FILE__)) {
        continue;
    }
    // 仅处理PHP文件（可根据需求移除该判断）
    if (pathinfo($file, PATHINFO_EXTENSION) !== 'php') {
        continue;
    }
    
    // 检查文件名是否以BOM开头（PHP 8.0+可用str_starts_with）
    if (substr($file, 0, 3) === $bom) {
        // 移除开头的3个BOM字节
        $newName = substr($file, 3);
        $oldPath = $directory . DIRECTORY_SEPARATOR . $file;
        $newPath = $directory . DIRECTORY_SEPARATOR . $newName;
        
        // 执行重命名并处理可能的错误
        if (rename($oldPath, $newPath)) {
            echo "已重命名：{$oldPath} → {$newPath}<br>";
        } else {
            echo "重命名失败：{$oldPath}<br>";
        }
    } else {
        echo "无BOM无需处理：{$file}<br>";
    }
}
?>

代码说明 #

1. BOM字节定义：$bom = "\xEF\xBB\xBF"直接对应UTF-8 BOM的三个字节，这是文件名中实际存在的内容
2. 目录条目过滤：用array_filter排除.和..，避免处理父目录和当前目录
3. BOM检测：使用substr($file, 0, 3) === $bom兼容所有PHP版本，若使用PHP 8.0+可替换为更简洁的str_starts_with($file, $bom)
4. 重命名逻辑：通过substr($file, 3)移除开头的3个BOM字节，生成新文件名后执行重命名
5. 错误处理：增加rename的返回值判断，输出操作结果，方便排查问题

内容的提问来源于stack exchange，提问作者GuyTryingToSolveAnIssue