17370845950

PHP导入Excel时性别字段需将“男”“女”映射为1/2，推荐用静态数组$genderMap=['男'=>1,'女'=>2,'未知'=>0]，配合trim()和strtolower()预处理，并按列索引读取避免中文表头乱码，同时校验合法性、显式类型转换及空值处理。

PHP 导入 Excel 时性别字段存数字（1/2）但源数据是“男”“女”

直接用 fgetcsv 或 PhpSpreadsheet 读取 Excel 后，gender 列值是字符串 “男” 或 “女”，而数据库要求整型 1（男）、2（女）。不能靠数据库默认值或触发器兜底，必须在 PHP 层完成映射。

• 推荐用静态映射数组，避免多次查表或 switch 嵌套：

  $genderMap = ['男' => 1, '女' => 2, '未知' => 0];
  $rawGender = trim($row['性别']);
  $gender = $genderMap[$rawGender] ?? 0;

• 注意全角空格、换行符干扰：trim() 必须加，否则 '男 ' 查不到键
• Excel 中可能出现 “M”/“F”、“Male”/“Female”，建议统一预处理：先转小写，再映射：strtolower($rawGender)

用 PhpSpreadsheet 读取时中文列名乱码导致性别列取不到

Excel 表头是 “性别”，但 $worksheet->getCell('B1')->getValue() 返回乱码或空值，常见于 GBK 编码的旧 Excel 文件。

• 加载时强制指定编码：

  $reader = new \PhpOffice\PhpSpreadsheet\Reader\Xlsx();
  // 若为 .xls（Excel 2003），改用 Excel5 并设置编码
  $reader = new \PhpOffice\PhpSpreadsheet\Reader\Excel5();
  $reader->setEncoding('GBK');

• 更稳妥的方式是按列索引读，不依赖中文表头：$genderCell = $worksheet->getCellByColumnAndRow(2, $rowIndex); // 第3列（B列）
• 用 getActiveSheet()->rangeToArray() 批量读取后，手动跳过首行表头，再逐行处理

导入前校验性别值合法性，避免脏数据入库

用户上传的 Excel 可能填了“男生”“girl”“1”“male”等非常规值，仅靠映射数组会静默转成 0 或报错，需主动拦截并提示具体行号。

• 校验逻辑要放在循环内，结合行号反馈：

  if (!isset($genderMap[$rawGender])) {
      $errors[] = "第 {$rowIndex} 行：性别值 '{$rawGender}' 不合法，请填写‘男’或‘女’";
      continue;
  }

• 数据库字段类型设为 TINYINT(1) UNSIGNED，配合 NOT NULL DEFAULT 0，防止 NULL 入库
• 若业务允许模糊匹配（如“男”“男士”“boy”都算男），可用正则：preg_match('/^(男|男士|male|boy|1)$/i', $rawGender)

批量插入时 gender 字段被当成字符串导致 MySQL 报错 1366

拼 SQL 或用 PDO 插入时，如果没显式类型转换，$gender 虽然是整数，但 PDO 可能按字符串绑定，MySQL 在 strict 模式下拒绝隐式转换。

• 显式强转：(int)$gen

  

  der 或 intval($gender)，不要只依赖映射数组返回值类型
• PDO 绑定时指定参数类型：

  $stmt->bindValue(':gender', $gender, PDO::PARAM_INT);

• 用 mysqli_real_escape_string 对性别字段做处理是无效的——它只处理字符串，对数字无意义，反而可能引入逻辑错误

实际导入中，最易被忽略的是 Excel 文件编码与 PHP 读取器编码不一致，以及未对原始单元格值做 trim() 和空值判断。这两点导致的“性别识别失败”占线上问题的七成以上。