PHP中ucfirst函数未将数组首个元素首字母大写的问题排查与解决

首先，我一眼就注意到你的问题里只有第一个CSV表头medicaid_number没有被正确处理成setMedicaid_number，其他字段都正常——这种情况十有八九是**UTF-8字节顺序标记（BOM）**在捣乱！

问题根源分析 #

当你的CSV文件是用带BOM的UTF-8编码保存时，文件开头会被加上三个不可见的字节：EF BB BF。file_get_contents读取文件时会把这三个字节包含进去，成为第一个表头字段的前缀。

而trim()函数默认只会去除空格、换行、制表符这类常规空白字符，不会处理BOM。这就导致ucfirst()实际上是在处理BOM之后的字符——BOM本身不是字母，所以ucfirst()不会对它做任何操作，后面的m自然还是小写，最终输出就是setmedicaid_number。

排查验证方法 #

你可以加一行代码验证这个猜想，看看第一个表头字段的开头是不是真的有BOM：

// 输出第一个表头字段的前3个字节的十六进制值
var_dump(bin2hex(substr($export_array[0][0], 0, 3)));

如果输出是string(6) "efbbbf"，那就实锤是BOM的问题了！

解决方案 #

这里有几种简单的解决方式，选一种适合你的就行：

方法1：读取文件时直接去掉BOM

在读取文件内容后，先移除开头的BOM：

$file = "client_export_data.csv";
$csv = file_get_contents($file);
// 移除UTF-8 BOM
if (substr($csv, 0, 3) == pack("CCC", 0xef, 0xbb, 0xbf)) {
    $csv = substr($csv, 3);
}
$export_array = array_map("str_getcsv", explode("\n", $csv));

方法2：处理单个表头字段时去除BOM

如果不想修改整个文件的读取逻辑，也可以在处理每个表头字段时单独去掉BOM：

foreach($export_array as $lineKey => $line){
    foreach($line as $key => $item){
        // 先去除常规空白，再去掉开头的BOM
        $header = ltrim(trim($item), "\xef\xbb\xbf");
        $func = 'set'. ucfirst($header);
        var_dump($func);
    }
    die();
}

额外优化建议

你的代码里直接用了$export_array[0][$key]，其实内层循环的$item就是当前行的字段值，当你处理第一行（表头行）时，直接用$item会更清晰；甚至可以直接遍历表头行，省去外层循环：

// 直接遍历表头行，逻辑更简洁
foreach($export_array[0] as $key => $header){
    $header = ltrim(trim($header), "\xef\xbb\xbf");
    $func = 'set'. ucfirst($header);
    var_dump($func);
}
die();

内容来源于stack exchange