php 8.6用pdo sqlite导入一批记录时,可以先建好受控表结构,再在一个事务中复用预处理语句。中途任何一条违反约束或校验失败,都回滚当前批次;不要把已经插入前几条就当作整批成功。

PHP官方文档中的SQLite事务相关说明。 图源:PHP Documentation Group(CC BY3.0)。
准备受控数据库和固定表结构
<?php
$pdo = new PDO('sqlite:' . __DIR__ . '/import.sqlite', null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$pdo->exec('PRAGMA foreign_keys = ON');
$pdo->exec('PRAGMA busy_timeout = 3000');
$pdo->exec('CREATE TABLE IF NOT EXISTS records (id INTEGER PRIMARY KEY, label TEXT NOT NULL)');
$rows = [['id' => 1, 'label' => '甲'], ['id' => 2, 'label' => '乙']];
try {
$pdo->beginTransaction();
$insert = $pdo->prepare('INSERT INTO records (id, label) VALUES (:id, :label)');
foreach ($rows as $row) {
if (!is_int($row['id']) || $row['id'] < 1 || !is_string($row['label']) || strlen($row['label']) > 200) {
throw new InvalidArgumentException('记录不符合约定');
}
$insert->bindValue(':id', $row['id'], PDO::PARAM_INT);
$insert->bindValue(':label', $row['label'], PDO::PARAM_STR);
$insert->execute();
}
$pdo->commit();
} catch (Throwable $e) {
if ($pdo->inTransaction()) { $pdo->rollBack(); }
throw $e;
}
echo 'batch committed', PHP_EOL;用重复主键验证整批回滚
先记录测试库现有行数,再让同一批两条数据使用相同id。第二条应失败,第一条属于当前事务的新增也应撤销,原有记录则保持不变。重复运行成功示例可能因为已有主键而失败,这是插入策略,不代表事务失效。
处理并发与批次大小
busy_timeout只让锁冲突等待指定时间,不保证永远成功。批次应限制大小和处理时长,遇锁超时后按业务策略重试整个明确批次,而不是在未知提交结果时换一批ID重新插入。数据库文件及目录要有正确权限,也不应放在公网可下载目录。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。

PHP官方文档中的SQLite事务相关说明。 图源:PHP Documentation Group(CC BY3.0)。
这里使用的是SQLite自己的事务能力,不是8.6新增PDO语法。CREATE TABLE放在批次事务之前,业务批次只执行固定DML;切换其他数据库时还需核对DDL隐式提交和驱动语义。提交成功不等于已备份或可以忽略磁盘故障。


















