在php开发中，二维数组是存储批量结构化数据的常用形式，比如从表单提交的多个用户信息、接口返回的批量商品数据等，将这些数据写入数据库是高频需求。下面详细介绍具体的实现步骤和相关技巧。
准备工作
首先需要确保已经正确配置好数据库连接，这里以mysql数据库为例，使用mysqli扩展进行连接，示例代码如下：
<?php
// 数据库连接配置
$host = '127.0.0.1';
$user = 'root';
$password = 'root';
$database = 'test_db';
// 创建连接
$conn = new mysqli($host, $user, $password, $database);
// 检查连接是否成功
if ($conn->connect_error) {
die("数据库连接失败: " . $conn->connect_error);
}
// 设置字符集为utf8，避免中文乱码
$conn->set_charset('utf8');
?>
二维数组结构梳理
在写入数据库前，需要先明确二维数组的结构，确保数组的键名和数据库表的字段名对应，假设我们有一个存储用户信息的二维数组，结构如下：
<?php
// 待写入数据库的二维数组
$user_list = [
['name' => '张三', 'age' => 25, 'email' => 'zhangsan@ipipp.com'],
['name' => '李四', 'age' => 28, 'email' => 'lisi@ipipp.com'],
['name' => '王五', 'age' => 22, 'email' => 'wangwu@ipipp.com']
];
?>
对应的数据库表user结构为：id（自增主键）、name（用户名）、age（年龄）、email（邮箱）。
单条循环写入方式
最基础的写入方式是遍历二维数组，逐条执行插入sql语句，实现代码如下：
<?php
// 单条循环写入二维数组数据
foreach ($user_list as $user) {
// 拼接插入sql语句，注意对字符串类型的值进行转义，避免sql注入
$name = $conn->real_escape_string($user['name']);
$age = intval($user['age']);
$email = $conn->real_escape_string($user['email']);
$sql = "INSERT INTO user (name, age, email) VALUES ('$name', $age, '$email')";
if ($conn->query($sql) === TRUE) {
echo "第" . ($key+1) . "条数据插入成功<br/>";
} else {
echo "第" . ($key+1) . "条数据插入失败: " . $conn->error . "<br/>";
}
}
?>
这种方式逻辑简单，但是当二维数组数据量较大时，会频繁和数据库交互，执行效率较低，适合数据量较小的场景。
批量插入优化方式
为了提升写入效率，可以将二维数组的数据拼接成一条批量插入的sql语句，减少数据库交互次数，实现代码如下：
<?php
// 批量插入二维数组数据
$values = [];
foreach ($user_list as $user) {
$name = $conn->real_escape_string($user['name']);
$age = intval($user['age']);
$email = $conn->real_escape_string($user['email']);
$values[] = "('$name', $age, '$email')";
}
// 拼接批量插入sql
if (!empty($values)) {
$sql = "INSERT INTO user (name, age, email) VALUES " . implode(',', $values);
if ($conn->query($sql) === TRUE) {
echo "批量插入成功，共插入" . count($user_list) . "条数据<br/>";
} else {
echo "批量插入失败: " . $conn->error . "<br/>";
}
}
?>
这种方式只需要执行一次sql语句，写入效率远高于单条循环方式，适合数据量较大的批量写入场景。
注意事项
- 所有用户输入或者外部获取的二维数组数据，在拼接sql前必须进行转义，避免sql注入攻击，可以使用
real_escape_string方法或者预处理语句。 - 如果二维数组的数据量非常大，比如超过几千条，建议分批次拼接批量插入sql，避免单条sql语句过长导致执行失败。
- 写入前可以检查二维数组的键名是否存在，避免因为数组结构异常导致sql拼接错误，示例判断代码：
if (isset($user['name']) && isset($user['age']) && isset($user['email']))。 - 操作完成后记得关闭数据库连接，释放资源：
$conn->close();。
预处理语句实现方式
使用预处理语句可以更安全地实现二维数组写入，避免手动转义的问题，代码如下：
<?php
// 预处理语句批量写入
$sql = "INSERT INTO user (name, age, email) VALUES (?, ?, ?)";
$stmt = $conn->prepare($sql);
if ($stmt === FALSE) {
die("预处理失败: " . $conn->error);
}
// 绑定参数类型，s代表字符串，i代表整数
$stmt->bind_param('sis', $name, $age, $email);
foreach ($user_list as $user) {
$name = $user['name'];
$age = $user['age'];
$email = $user['email'];
if ($stmt->execute() === FALSE) {
echo "数据插入失败: " . $stmt->error . "<br/>";
}
}
$stmt->close();
echo "预处理方式写入完成<br/>";
?>
预处理语句会自动处理参数转义，安全性更高，是生产环境推荐的使用方式。
php二维数组数据库写入mysql_insert修改时间：2026-07-04 13:24:26