
本文介绍如何在 php 中使用 sql server 的 prepared statement 高效批量插入多条结构相同、仅序列号(如 voucher_sn)不同的记录,并提供安全、可维护的表单与代码实现。
本文介绍如何在 php 中使用 sql server 的 prepared statement 高效批量插入多条结构相同、仅序列号(如 voucher_sn)不同的记录,并提供安全、可维护的表单与代码实现。
在实际业务中,常需为同一客户、同一有效期、同一类型生成连续编号的凭证(如优惠券、电子券),例如 voucher_sn 从 100 到 105 共 6 条记录,其余字段(client、generate_date、expiry_date 等)完全一致。直接拼接 SQL 字符串易引发注入风险且性能低下;而逐条 INSERT 未复用预编译语句则浪费资源。最佳实践是:使用参数化预编译语句 + 单次准备、多次执行(with bound variable update)。
✅ 正确实现步骤
1. HTML 表单设计(支持范围输入)
确保表单包含起始与终止序列号字段,并统一命名便于后端处理:
⚠️ 注意:务必添加
required和min="1"等基础校验,前端验证仅为体验优化,后端必须二次校验。
2. PHP 后端逻辑(安全 & 高效)
关键要点:
- 使用
sqlsrv_prepare()一次准备语句; - 将
voucher_sn设为可变绑定参数(即在循环中更新其值); - 其余字段作为静态绑定参数传入
sqlsrv_prepare(); - 循环内仅调用
sqlsrv_execute(),避免重复解析。
<?php // 假设 $conn 已通过 sqlsrv_connect() 建立并验证
if (!$conn) {
die("数据库连接失败: " . print_r(sqlsrv_errors(), true));
}
// ✅ 严格过滤与校验输入
$voucher_from = filter_input(INPUT_POST, 'voucher_sn_from', FILTER_VALIDATE_INT);
$voucher_to = filter_input(INPUT_POST, 'voucher_sn_to', FILTER_VALIDATE_INT);
$client = trim($_POST['client'] ?? '');
$generate_date = $_POST['generate_date'] ?? '';
$expiry_date = $_POST['expiry_date'] ?? '';
if (!$voucher_from || !$voucher_to || $voucher_from > $voucher_to ||
empty($client) || !strtotime($generate_date) || !strtotime($expiry_date)) {
die("参数错误:请检查凭证编号范围、客户名及日期格式。");
}
// ✅ 构建参数化 INSERT 语句(voucher_sn 是唯一变化字段)
$tsql = "INSERT INTO dbo.vouchers
(voucher_sn, generate_date, expiry_date, client, is_used, location_used, used_date, payed, payed_date)
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)";
// ✅ 绑定参数:voucher_sn 为引用变量(&$voucher),其余为固定值
$params = [
&$voucher, // ← 动态更新的序列号(PHP 引用传递)
$generate_date,
$expiry_date,
$client,
$_POST['is_used'] ?? 0,
$_POST['location_used'] ?? '',
$_POST['used_date'] ?? null,
$_POST['payed'] ?? 0,
$_POST['payed_date'] ?? null
];
$stmt = sqlsrv_prepare($conn, $tsql, $params);
if (!$stmt) {
die("预编译失败: " . print_r(sqlsrv_errors(), true));
}
// ✅ 执行循环:每次仅更新 $voucher 值并执行
$addedCount = 0;
for ($voucher = $voucher_from; $voucher ✅ 成功插入 {$addedCount} 条凭证记录(voucher_sn: {$voucher_from}–{$voucher_to})。";
?>
? 关键注意事项
-
参数绑定顺序必须严格匹配
?占位符顺序,且voucher_sn必须是第一个?(因它需动态更新); - 使用
&$voucher是核心技巧——sqlsrv_prepare()绑定的是变量引用,后续修改$voucher值会自动反映在下一次sqlsrv_execute()中; - 永远不要拼接用户输入到 SQL 字符串中,本方案全程使用参数化查询,杜绝 SQL 注入;
- 若需更高性能(万级记录),可考虑
INSERT ... SELECT+master..spt_values生成数字序列,但本场景推荐当前方案——简洁、可控、事务友好; - 生产环境建议包裹在事务中(
sqlsrv_begin_transaction()/sqlsrv_commit()/sqlsrv_rollback()),确保全部成功或全部回滚。
通过以上结构化实现,你既能安全、高效地完成“同实体多序列号”批量插入,又为后续扩展(如添加日志、并发控制、异步队列)打下坚实基础。










