WordPress中PHP导入CSV到MySQL仅插入行数无字段值问题

问题复现代码 #

当前使用的导入代码如下：

<?php
global $wpdb;
 $table_name = $wpdb->prefix . 'excelvalues'; 
echo $table_name;
if(isset($_POST["submit_file"]))
{
 $file = "example.csv"//$_FILES["file"]["tmp_name"];
 $file_open = fopen($file,"r");
 while(($csv = fgetcsv($file_open, 1000, ",")) !== false)
 {
 $Anrede = $csv[0];
 $Titel = $csv[1];
 $Nachname = $csv[2];
 $Vorname = $csv[3];
 $Strasse = $csv[4];
 $LKZ = $csv[5];
 $PLZ = $csv[6];
 $Ort = $csv[7];
 $Mobil = $csv[8];
 $Email = $csv[9];
 $Geburtsdatum = $csv[10];
 $Eintrittsdatum = $csv[11];
 $Prüfungsjahr = $csv[12];
 $Vermittlung = $csv[13];
 $Bezirk = $csv[14];
 $Kartennummer = $csv[15];
 $LinkQR = $csv[16];
 $wpdb->query("INSERT INTO $table_name(ID, Anrede, Titel,Nachname,Vorname,Strasse,LKZ,PLZ,Ort,Mobil,Email,Geburtsdatum,Eintrittsdatum,Prüfungsjahr,Vermittlung,Bezirk,Kartennummer,LinkQR) VALUES(NULL, '$Anrede', '$Titel', '$Nachname', '$Vorname', '$Strasse', '$LKZ', '$PLZ', '$Ort', '$Mobil', '$Email', '$Geburtsdatum', '$Eintrittsdatum', '$Prüfungsjahr', '$Vermittlung', '$Bezirk', '$Kartennummer', '$LinkQR')");
 }
 }
 ?>

核心错误原因 #

出现插入行数和CSV行数一致、但所有字段为空的问题，由以下几个常见问题导致，按出现概率排序：

• 未配置正确的系统locale，fgetcsv无法识别特殊字符：字段包含Prüfungsjahr这类带德语变音的非ASCII字符时，PHP的fgetcsv函数依赖系统locale配置读取内容，locale不匹配时会直接返回空字符串，是该场景下最高发的诱因。
• 基础语法错误：贴出的代码中$file = "example.csv"行末尾缺少分号，会引发语法解析异常，若本地运行未报错需先确认是否为贴代码时的笔误。
• CSV文件格式不匹配：
  • Windows导出的CSV默认常为GBK/ANSI编码，和WordPress、MySQL默认使用的UTF-8编码不兼容，读取后内容异常会被数据库过滤为空
  • 欧洲地区导出的CSV默认常用分号;作为字段分隔符，而非代码中写的逗号,，会导致fgetcsv将整行识别为单个字段，其余索引位置全部为空
  • 带UTF-8 BOM头的CSV文件会让第一行第一个字段携带不可见BOM字符，严重时会引发全行列索引错位
• SQL拼接无转义引发解析失败：直接将变量拼接到SQL语句中未做转义，一旦字段内容包含单引号、反斜杠等特殊字符，会导致INSERT语句语法错误，无法正确写入字段值。
• fgetcsv长度限制截断内容：代码中fgetcsv的行长度参数设置为1000，若CSV单行内容超过1000字符会被强制截断，后续字段全部读取为空。

修复后可运行代码 #

<?php
global $wpdb;
$table_name = $wpdb->prefix . 'excelvalues'; 

if(isset($_POST["submit_file"]))
{
    // 配置德语区域，适配特殊字符读取
    setlocale(LC_ALL, 'de_DE.UTF-8', 'de_DE', 'de');
    // 补全分号，正式使用时替换为上传文件临时路径
    $file = "example.csv";
    $file_open = fopen($file,"r");
    
    // 过滤UTF-8 BOM头
    $bom = pack('H*','EFBBBF');
    $first_line = fgets($file_open);
    $first_line = preg_replace("/^$bom/", '', $first_line);
    $csv = str_getcsv($first_line, ",");
    // 若CSV第一行是表头不需要导入，直接注释掉下面首个插入块即可
    
    // 跳过空行
    if (!empty(array_filter($csv))) {
        $insert_data = [
            'ID' => NULL,
            'Anrede' => $csv[0] ?? '',
            'Titel' => $csv[1] ?? '',
            'Nachname' => $csv[2] ?? '',
            'Vorname' => $csv[3] ?? '',
            'Strasse' => $csv[4] ?? '',
            'LKZ' => $csv[5] ?? '',
            'PLZ' => $csv[6] ?? '',
            'Ort' => $csv[7] ?? '',
            'Mobil' => $csv[8] ?? '',
            'Email' => $csv[9] ?? '',
            'Geburtsdatum' => $csv[10] ?? '',
            'Eintrittsdatum' => $csv[11] ?? '',
            'Prüfungsjahr' => $csv[12] ?? '',
            'Vermittlung' => $csv[13] ?? '',
            'Bezirk' => $csv[14] ?? '',
            'Kartennummer' => $csv[15] ?? '',
            'LinkQR' => $csv[16] ?? ''
        ];
        // 自动转码适配不同编码的CSV文件，确认CSV为UTF-8时可注释该段
        $insert_data = array_map(function($val) {
            return mb_convert_encoding($val, 'UTF-8', 'GBK,UTF-8,ASCII');
        }, $insert_data);
        // 调用wpdb原生insert方法，自动做转义避免SQL语法错误
        $wpdb->insert($table_name, $insert_data);
    }

    // 循环处理剩余行，长度参数传0表示不限制行长度，避免截断
    while(($csv = fgetcsv($file_open, 0, ",")) !== false)
    {
        if (empty(array_filter($csv))) {
            continue;
        }
        $insert_data = [
            'ID' => NULL,
            'Anrede' => $csv[0] ?? '',
            'Titel' => $csv[1] ?? '',
            'Nachname' => $csv[2] ?? '',
            'Vorname' => $csv[3] ?? '',
            'Strasse' => $csv[4] ?? '',
            'LKZ' => $csv[5] ?? '',
            'PLZ' => $csv[6] ?? '',
            'Ort' => $csv[7] ?? '',
            'Mobil' => $csv[8] ?? '',
            'Email' => $csv[9] ?? '',
            'Geburtsdatum' => $csv[10] ?? '',
            'Eintrittsdatum' => $csv[11] ?? '',
            'Prüfungsjahr' => $csv[12] ?? '',
            'Vermittlung' => $csv[13] ?? '',
            'Bezirk' => $csv[14] ?? '',
            'Kartennummer' => $csv[15] ?? '',
            'LinkQR' => $csv[16] ?? ''
        ];
        $insert_data = array_map(function($val) {
            return mb_convert_encoding($val, 'UTF-8', 'GBK,UTF-8,ASCII');
        }, $insert_data);
        $wpdb->insert($table_name, $insert_data);
    }
    fclose($file_open);
}
?>

快速排查步骤 #

替换代码后仍有问题按顺序检查：

• 在while循环内添加var_dump($csv);exit;打印第一行读取结果，确认fgetcsv是否能正确获取每个字段的值，若数组全空优先检查CSV分隔符、locale配置、文件编码
• 若$csv数组值正常，检查数据库表字段编码是否为utf8mb4_unicode_ci，字段类型是否和写入内容匹配
• 开启WordPress debug模式，查看$wpdb->last_error和$wpdb->last_query输出，确认SQL语句是否存在解析错误

生产环境使用时需要增加上传文件类型校验、权限校验，不要直接读取未校验的用户上传路径，避免引发任意文件读取风险。

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