
本文介绍使用 php + sql server 驱动(sqlsrv)高效批量插入多条结构相同、仅序列号(voucher_sn)递增变化的记录,通过预处理语句与循环实现安全、高性能的数据写入。
本文介绍使用 php + sql server 驱动(sqlsrv)高效批量插入多条结构相同、仅序列号(voucher_sn)递增变化的记录,通过预处理语句与循环实现安全、高性能的数据写入。
在实际业务场景中(如批量生成电子券、会员卡号、凭证编号等),常需为同一客户、同一类型、同一有效期的一组凭证,分配连续的唯一序列号(如 voucher_sn 从 100 到 105)。此时,不应拼接多条 INSERT 语句,而应采用参数化预处理 + 循环执行的方式,兼顾安全性、可维护性与性能。
✅ 正确实现步骤
1. 前端表单设计(支持范围输入)
为用户暴露两个数字输入框,分别用于指定序列号起始值和结束值:
<p>
<label for="voucher_sn_from">凭证序列号(起始)</label><br>
<input type="number" name="voucher_sn_from" id="voucher_sn_from" required min="1">
</p>
<p>
<label for="voucher_sn_to">凭证序列号(结束)</label><br>
<input type="number" name="voucher_sn_to" id="voucher_sn_to" required min="1">
</p>
<p>
<label for="client">客户名称</label><br>
<input type="text" name="client" id="client" required>
</p>
<p>
<label for="generate_date">生成日期</label><br>
<input type="date" name="generate_date" id="generate_date" required>
</p>
<p>
<label for="expiry_date">到期日期</label><br>
<input type="date" name="expiry_date" id="expiry_date" required>
</p>
<!-- 其他字段依需补充,如 is_used、payed 等 -->⚠️ 注意:务必添加
required和min="1"等约束,并在后端二次校验,防止非法输入。
2. 后端 PHP 批量插入逻辑
关键要点:
- 使用
sqlsrv_prepare()创建一次预处理语句; - 将
voucher_sn设为循环变量(绑定为引用参数); - 其余字段(如 client、dates 等)作为固定参数传入;
- 在循环内仅调用
sqlsrv_execute(),避免重复编译。
// 数据库连接(示例,需替换为实际配置)
$serverName = "your_server";
$connectionOptions = [
"Database" => "your_db",
"Uid" => "your_user",
"PWD" => "your_pass"
];
$conn = sqlsrv_connect($serverName, $connectionOptions);
if (!$conn) {
die("数据库连接失败: " . print_r(sqlsrv_errors(), true));
}
// 获取并验证表单数据
$voucher_from = (int)$_POST['voucher_sn_from'];
$voucher_to = (int)$_POST['voucher_sn_to'];
$client = trim($_POST['client'] ?? '');
$generate_date = $_POST['generate_date'] ?? date('Y-m-d');
$expiry_date = $_POST['expiry_date'] ?? date('Y-m-d');
$is_used = isset($_POST['is_used']) ? 1 : 0;
$location_used = $_POST['location_used'] ?? null;
$used_date = $_POST['used_date'] ?? null;
$payed = isset($_POST['payed']) ? 1 : 0;
$payed_date = $_POST['payed_date'] ?? null;
// 校验输入合法性
if ($voucher_from > $voucher_to || $voucher_from < 1 || strlen($client) === 0) {
die("错误:序列号范围无效或客户信息为空。");
}
// 构建预处理语句(所有字段显式声明,避免歧义)
$tsql = "INSERT INTO dbo.vouchers
(voucher_sn, generate_date, expiry_date, client,
is_used, location_used, used_date, payed, payed_date)
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)";
// 参数数组:voucher_sn 是动态变化的,其余为静态值
$params = [
&$voucher_from, // 引用传递,循环中会更新
$generate_date,
$expiry_date,
$client,
$is_used,
$location_used,
$used_date,
$payed,
$payed_date
];
$stmt = sqlsrv_prepare($conn, $tsql, $params);
if (!$stmt) {
die("预处理语句创建失败: " . print_r(sqlsrv_errors(), true));
}
// 执行循环插入
$insertedCount = 0;
for ($sn = $voucher_from; $sn <= $voucher_to; $sn++) {
// 更新引用参数 voucher_from → 当前 sn(因 $params[0] 是 &$voucher_from)
$voucher_from = $sn;
if (sqlsrv_execute($stmt) === false) {
$errors = sqlsrv_errors();
error_log("SQL 插入失败 (SN=$sn): " . print_r($errors, true));
die("第 {$sn} 条记录插入失败,请检查日志。");
}
$insertedCount++;
}
echo "<p>✅ 成功插入 {$insertedCount} 条凭证记录(序列号:{$voucher_from - $insertedCount + 1} – {$voucher_to})。</p>";
sqlsrv_free_stmt($stmt);
sqlsrv_close($conn);? 关键注意事项
-
参数引用机制:
$params[0]必须是&$voucher_from的引用,否则循环中无法更新绑定值; - 防 SQL 注入:全程使用参数化查询,杜绝字符串拼接;
-
事务建议:若需强一致性(如全部成功或全部回滚),可在
for循环外包裹sqlsrv_begin_transaction()和sqlsrv_commit()/sqlsrv_rollback(); -
性能提示:对于超大批量(如 >1000 条),可考虑改用
INSERT ... SELECT+ 临时表或 SQL Server 的GENERATE_SERIES()(SQL Server 2022+),但本方案对百级数据已足够高效; -
字段映射:确保 HTML 表单
name属性与$_POST键名严格一致,且数据库列名、类型与 PHP 提交值兼容(如日期格式应为'Y-m-d')。
通过以上结构化实现,你不仅能安全、清晰地完成“同实体多序列号”的批量插入,还为后续扩展(如并发控制、日志审计、异步生成)打下坚实基础。

















