如何实现PHP数据导入校验-php教程-PHP中文网

php数据导入校验需在解析、转换、入库三环节设防：解析时过滤空sheet与无效行；转换时清洗并校验字段格式；入库前预检唯一性与外键，统一收集带行号的错误详情。

如何实现php数据导入校验

PHP数据导入校验不是加个if就能完事的——它必须在解析、转换、入库三个环节都设防，否则脏数据会悄无声息地污染数据库。

很多同学用PhpSpreadsheet读完直接foreach循环，结果遇到空行、合并单元格、隐藏列或空白Sheet就崩。这些不是“数据问题”，是“输入结构问题”，得在解析层拦截。

用$reader->listWorksheetInfo($filename)先检查是否有非空Sheet，跳过worksheetName === ''或totalRows === 0的表
读取后立刻用$sheet->getHighestRow()和getHighestColumn()确认范围，再逐行判断$sheet->getCell("A{$row}")->getValue()是否为null或trim() === ''，整行为空就continue
避免用getCellByColumnAndRow()硬编码列索引，改用getRowIterator()->current()->getCellIterator()配合getCoordinate()动态识别有效单元格

filter_var($val, FILTER_VALIDATE_EMAIL)看着省事，但实际导入中常遇到邮箱带空格、中文逗号分隔多邮箱、手机号带括号或横线——这类“人眼合法、机器拒收”的情况必须前置清洗。

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

邮箱：先trim()再str_replace(['　', ' ', '，'], ['', '', ','], $val)，再按explode(',', $val)拆成数组逐个校验
手机号：用preg_replace('/[^\d+]/', '', $val)剥离所有非数字字符（保留+），再判断长度和前缀（如^1[3-9]\d{9}$）
日期：优先用DateTime::createFromFormat('Y-m-d', $val)而非strtotime()，后者对2024/02/30这种非法日期会静默转成下个月

等INSERT INTO ... VALUES (...),(...)执行时报SQLSTATE[23000]: Integrity constraint violation就晚了——错误堆栈里根本看不出哪条数据出问题，更没法定位原始Excel行号。

把待入库的user_code、mobile等唯一字段提前查库：SELECT mobile FROM users WHERE mobile IN (...)，比对出重复项并记录row => 15, field => 'mobile', value => '138****1234'
外键字段（如dept_id）不要等INSERT失败才反馈，先SELECT id FROM departments WHERE id IN (1,2,999)，缺失的ID单独归类
所有预检结果统一收集到一个$errors数组，结构为['rows' => [15 => ['mobile' => '已存在']], 'warnings' => [22 => ['status' => '未知状态值']]]，方便前端高亮错误行

用$pdo->beginTransaction()包住整个导入看似保险，但一旦触发回滚，用户只看到“导入失败”，却不知道是第37行身份证号校验失败，还是第82行数据库连接超时——日志里没上下文，下次还踩同一个坑。

在事务内每处理100行就gc_collect_cycles()一次，防止PhpSpreadsheet对象长期驻留内存OOM
把每行的原始值、清洗后值、校验结果、SQL绑定参数全写进error_log()，格式如[import][row:45] raw='张三,138xxxx1234' → cleaned=['name'=>'张三','mobile'=>'138xxxx1234'] → errors=['mobile'=>'格式错误']
最终成功数、跳过数、警告数、错误数必须返回给前端，且错误详情要带Excel行号，不能只写“共5条数据异常”

真正难的不是写校验逻辑，而是让每条报错都能反向定位到Excel里那一格——这需要把校验动作和原始坐标牢牢绑在一起，而不是等抛出异常才去猜。