PHP 8.1 Excel二维数组去重需先清洗（trim、类型统一、过滤空行），再按指定列生成唯一键实现语义化去重，兼容动态表头，利用联合类型和nullsafe提升健壮性。
PHP 8.1 对 Excel 导入的二维数组去重，关键在于：Excel 数据通常含表头、空行、类型混杂（如数字被读作字符串）、字段顺序不固定，且业务上往往不是“全字段完全一致才去重”，而是按「指定列」（如手机号、订单号、URL）判重。直接套用 array_unique() 会失败，必须结合数据清洗与语义化去重逻辑。
先清洗再判重：处理 Excel 常见脏数据
Excel 导入后（例如用 PhpSpreadsheet），数组常含空值、空白字符串、多余空格、数字转字符串等。不去洗，后续去重会误判。
- 用
trim()清理所有字符串字段，避免前后空格导致“张三”和“张三 ”被判为不同 - 对数字型字段（如 ID、电话）用
(int)或filter_var($val, FILTER_SANITIZE_NUMBER_INT)统一类型，防止"123"和123被当成两个键 - 过滤掉全为空或只有空格的子数组：
array_filter($rows, fn($row) => array_filter($row, 'trim')) - 若含日期列且需忽略（如仅按姓名+手机号去重），提前 unset 掉该键，避免干扰哈希计算
按指定字段去重：推荐用「唯一键 + 最新优先」策略
业务中常见需求是：相同手机号只留一条，且保留导入时间最新或 Excel 行号最大的那条。不推荐简单丢弃，而应有选择地保留。
tidy-excel-data
下载
清理、标准化、验证并汇总杂乱的 Excel 工作簿。当 Codex 需要处理 `.xlsx`、`.xls`、`.xlsm` 或 `.csv` 格式的数据时使用，包括：统一表头格式、删除空白行与空白列、修剪文本内容、去重记录、检测数据质量问题、拆分或合并工作表、生成清洗后的工作簿，以及为业务电子表格生成审计摘要。
- 遍历每行，提取目标字段（如
$row['mobile']和$row['email']）拼成唯一键：$key = $row['mobile'] . '|' . $row['email'] - 用关联数组以该键为索引存储整行：
$unique[$key] = $row—— 后面的自动覆盖前面的，天然实现“保留最后一条” - 若需保留“最早一条”，可加判断：
if (!isset($unique[$key])) { $unique[$key] = $row; } - 最终用
array_values($unique)重置数字索引，得到干净结果
兼容键名不固定的数组：用 array_column + array_keys 安全提取
Excel 表头可能大小写不一（Mobile / mobile）、含空格或特殊符号。硬写 $row['mobile'] 易报错。
立即学习“PHP免费学习笔记（深入）”；
- 先标准化键名：遍历首行（表头），用
strtolower(trim())统一，并建立映射表，如['mobile' => 2]表示第 3 列是手机号 - 之后取值改用下标：
$mobile = $row[$colMap['mobile']] ?? ''，避免键不存在警告 - 若原始数组是数值索引（无键名），可用
array_column($rows, 1)提取第 2 列全部值，再配合array_keys()和array_flip()做单列去重
性能与安全提醒（PHP 8.1 特性可利用）
大文件（如万行 Excel）需注意内存和效率。PHP 8.1 的联合类型、nullsafe 运算符和更严格的类型检查能帮你少踩坑。
- 函数参数加类型声明：
function dedupeByFields(array $data, array $keys): array，避免传入非数组崩溃 - 用 nullsafe 操作安全取值：
$row?['mobile']?->trim()（需配合对象封装，或自定义辅助函数） - 避免
serialize()方案：它在 PHP 8.1 中对含 Closure/Resource 的数组会失败，且性能差、不可读；仅当必须全字段严格比对且数据极小时才考虑 - 对超大数据，改用生成器逐行处理，不一次性加载全部到内存
