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 模式下拒绝隐式转换。
立即学习“PHP免费学习笔记（深入）”；
- 显式强转：
(int)$gender或intval($gender)，不要只依赖映射数组返回值类型 - PDO 绑定时指定参数类型：
$stmt->bindValue(':gender', $gender, PDO::PARAM_INT); - 用
mysqli_real_escape_string对性别字段做处理是无效的——它只处理字符串，对数字无意义，反而可能引入逻辑错误
实际导入中，最易被忽略的是 Excel 文件编码与 PHP 读取器编码不一致，以及未对原始单元格值做 trim() 和空值判断。这两点导致的“性别识别失败”占线上问题的七成以上。