php实现班级通信录怎么导入json数据

在班级通信录的开发过程中，经常会遇到需要将已有的json格式联系人数据导入到系统中的需求，php本身内置了json处理函数，能够很方便地完成这个操作。下面我们就一步步讲解具体的实现步骤。

步骤一：准备json数据文件

首先需要准备符合通信录数据结构的json文件，假设我们的班级通信录json数据包含学生姓名、学号、联系电话、班级字段，文件内容示例如下：

[
    {
        "name": "张三",
        "student_id": "2023001",
        "phone": "13800138001",
        "class_name": "三年级一班"
    },
    {
        "name": "李四",
        "student_id": "2023002",
        "phone": "13800138002",
        "class_name": "三年级一班"
    }
]

步骤二：读取json文件内容

使用php的file_get_contents函数读取json文件的内容，这里需要注意文件的路径是否正确，示例代码如下：

<?php
// 指定json文件路径，这里使用相对路径，根据实际项目调整
$jsonFilePath = './class_contacts.json';
// 读取文件内容
$jsonContent = file_get_contents($jsonFilePath);
if ($jsonContent === false) {
    die('读取json文件失败，请检查文件路径是否正确');
}
?>

步骤三：解析json数据

使用php内置的json_decode函数将json字符串转换为php数组，同时需要做错误校验，避免json格式错误导致解析失败：

<?php
// 将json字符串解析为关联数组，第二个参数传true返回数组，否则返回对象
$contactList = json_decode($jsonContent, true);
// 校验json解析是否成功
if (json_last_error() !== JSON_ERROR_NONE) {
    die('json数据解析失败，错误原因：' . json_last_error_msg());
}
// 校验解析后的数据是否为数组
if (!is_array($contactList)) {
    die('json数据格式不符合要求，应为数组结构');
}
?>

步骤四：连接数据库并创建通信录表

假设我们使用mysql数据库存储班级通信录数据，首先需要创建对应的数据表，表结构如下：

连接数据库并插入数据的php代码如下：

<?php
// 数据库配置，根据实际环境调整
$dbHost = '127.0.0.1';
$dbUser = 'root';
$dbPass = 'root';
$dbName = 'school_db';
// 创建数据库连接
$conn = new mysqli($dbHost, $dbUser, $dbPass, $dbName);
// 校验连接是否成功
if ($conn->connect_error) {
    die('数据库连接失败：' . $conn->connect_error);
}
// 设置字符集为utf8，避免中文乱码
$conn->set_charset('utf8');
?>

步骤五：遍历数据写入通信录表

遍历解析后的数组，将每一条联系人数据插入到数据库表中，同时可以做重复数据校验，避免重复导入：

<?php
// 遍历解析后的联系人数组
foreach ($contactList as $contact) {
    // 校验必填字段是否存在
    if (!isset($contact['name']) || !isset($contact['student_id']) || !isset($contact['phone']) || !isset($contact['class_name'])) {
        echo '存在缺少必填字段的数据，跳过该条记录<br/>';
        continue;
    }
    // 校验学号是否已存在，避免重复导入
    $checkSql = "SELECT id FROM class_contacts WHERE student_id = '{$contact['student_id']}'";
    $checkResult = $conn->query($checkSql);
    if ($checkResult && $checkResult->num_rows > 0) {
        echo "学号{$contact['student_id']}已存在，跳过导入<br/>";
        continue;
    }
    // 拼接插入sql，注意对特殊字符做转义处理
    $name = $conn->real_escape_string($contact['name']);
    $studentId = $conn->real_escape_string($contact['student_id']);
    $phone = $conn->real_escape_string($contact['phone']);
    $className = $conn->real_escape_string($contact['class_name']);
    $insertSql = "INSERT INTO class_contacts (name, student_id, phone, class_name) VALUES ('$name', '$studentId', '$phone', '$className')";
    if ($conn->query($insertSql)) {
        echo "学号{$contact['student_id']}的数据导入成功<br/>";
    } else {
        echo "学号{$contact['student_id']}的数据导入失败，错误：{$conn->error}<br/>";
    }
}
// 关闭数据库连接
$conn->close();
?>

注意事项

• 导入前一定要对json数据的格式做校验，避免不符合要求的数据导致程序报错
• 写入数据库时需要对用户输入的内容做转义处理，防止sql注入攻击
• 如果json数据量较大，建议分批次导入，避免一次性处理过多数据导致内存溢出
• 实际项目中可以根据需求增加更多的字段校验，比如手机号格式校验、学号格式校验等

phpjson解析班级通信录数据导入修改时间：2026-07-15 11:06:27