php实现班级通信录怎么导入mysql_php导入数据入库方法【步骤】

推荐用 phpSpreadsheet 库读取 excel 通信录，设 UTF-8 编码、清洗字段、用 INSERT IGNORE 批量插入，并建 utf8mb4 表结构；导入后捕获 sql 异常并分批提交事务。

PHP读取Excel班级通信录文件并插入mysql

直接用 fgetcsv() 读取 CSV 格式通信录最稳妥；若必须处理 Excel（.xlsx/.xls），别硬写解析逻辑，用 phpspreadsheet 库——它能自动识别格式、跳过空行、处理中文乱码，比自己写 simpleXML 或 COM 扩展靠谱得多。

常见错误是把 Excel 当纯文本用 file_get_contents() 读，结果得到一堆乱码二进制，或者用 iconv() 强转编码反而崩掉。正确做法是让库负责解包，PHP 只管字段映射。

• 确保 Excel 第一行是表头（如 name、student_id、phone、parent_phone），且无合并单元格
• 导入前用 mb_detect_encoding() 检查原始内容编码，但更推荐在 phpspreadsheet 中统一设 setInputEncoding('UTF-8')
• 对手机号、学号等字段做 trim() + filter_var($val, FILTER_SANITIZE_NUMBER_INT) 清洗，避免前后空格或换行符入库

批量插入时防重复、跳过非法数据

班级通信录常有重名、缺手机号、学号格式错（如“2023-001”混入字母）等问题，不能全靠前端校验。PHP 导入脚本里得做轻量级后端过滤，否则一条脏数据会导致整批 INSERT 失败或主键冲突。

推荐用 INSERT IGNORE INTO 或 INSERT ... ON DUPLICATE KEY UPDATE，前提是 MySQL 表中已为 student_id 或 name+class 组合加了唯一索引。否则光靠 PHP 判断“是否已存在”，并发导入时仍有概率漏判。

立即学习“PHP免费学习笔记（深入）”；

• 逐行验证：用 preg_match('/^[x{4e00}-x{9fa5}a-zA-Zs]+$/u', $name) 过滤姓名中的非法符号
• 手机号用 preg_match('/^1[3-9]d{9}$/', $phone) 粗筛（不替代运营商实名核验）
• 遇到空值或验证失败的行，记录到日志数组，最后统一输出警告，但不停止导入

MySQL表结构要匹配通信录字段语义

别直接建个 contact_list 表然后塞 20 个 VARCHAR(255) 字段。班级通信录核心字段就几个：学生姓名、学号、班级、联系电话、家长电话、家庭住址。地址可设 TEXT，其他用 VARCHAR(32) 足够，学号建议加 UNIQUE 约束。

容易被忽略的是字符集和排序规则：utf8mb4_unicode_ci 必须设，否则微信昵称里的 emoji 或生僻字（如“䶮”）存不进去，报错 Incorrect String value: 'xF0x9Fx92xA1'...。

• 建表 SQL 示例：

  CREATE TABLE class_contacts (   id INT AUTO_INCREMENT PRIMARY KEY,   student_id VARCHAR(32) NOT NULL UNIQUE,   name VARCHAR(32) NOT NULL,   class VARCHAR(16) NOT NULL,   phone VARCHAR(16),   parent_phone VARCHAR(16),   address TEXT,   created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

• 如果通信录含照片路径，不要存二进制大图，只存相对路径（如 uploads/photo_2023001.jpg），并确保该目录 Web 可读

执行导入后检查实际写入行数与报错明细

很多人以为 mysqli_affected_rows() 返回非负数就成功了，其实它只返回“被影响的行数”，不等于“成功插入的行数”。比如用 INSERT IGNORE 插入已存在的学号，返回 0，但不算失败；而某行因字段超长被截断，MySQL 默认不报错（STRICT_TRANS_TABLES 关闭时），affected_rows 仍显示 1。

真正可靠的反馈是捕获 mysqli_sql_exception 并记录具体哪一行、哪个字段出问题。简单场景下，可在循环内用 $mysqli->errno 和 $mysqli->Error 实时判断。

• 开启 MySQL 严格模式：SET sql_mode = 'STRICT_TRANS_TABLES';，让超长、空值等立刻报错
• 每 100 行做一次 mysqli_commit()（若启用了事务），避免单次导入卡死或内存溢出
• 导完别忘了关闭 phpspreadsheet 的 reader 对象：$reader->close();，否则大文件可能撑爆内存