php 8.6使用sqlite3时,可先启用异常、设置busytimeout,再执行pragma journal_mode=wal并读取实际结果。wal允许读写更好地并行,但仍然只有一个写入者,也可能返回sqlite_busy;它不能把数据库变成多写并发服务。

PHP手册中的SQLite3::exec
在本机可写目录打开数据库
需要SQLite3扩展,数据库和-wal、-shm文件应在同一主机的本地文件系统中。父目录需要可写,不把WAL数据库放在多台主机共享的网络文件系统上。
$db = new SQLite3('/srv/app/data/app.sqlite');
$db->enableExceptions(true);
if (!$db->busyTimeout(2000)) throw new RuntimeException('Busy handler failed');
$mode=$db->querySingle('PRAGMA journal_mode=WAL');
if (strtolower((string)$mode)!=='wal') {
throw new RuntimeException('WAL mode was not enabled');
}
echo $db->querySingle('PRAGMA journal_mode'), PHP_EOL;
echo $db->querySingle('PRAGMA busy_timeout'), PHP_EOL;

PHP手册中的SQLite3::busyTimeout
保持写事务短小
try {
$db->exec('BEGIN IMMEDIATE');
$q=$db->prepare('UPDATE counters SET value=value+1 WHERE name=:name');
$q->bindValue(':name','jobs',SQLITE3_TEXT);
$q->execute();
$db->exec('COMMIT');
} catch (Throwable $e) {
if ($db->querySingle('SELECT 1')!==false) {
try { $db->exec('ROLLBACK'); } catch (Throwable $ignored) {}
}
throw $e;
}
计数表需预先创建。不要把网络请求、等待用户输入或大文件处理放在写事务中;超出等待时间仍可能失败,调用方需要明确的失败响应。
Drizzle ORM 是一个轻量级的 TypeScript ORM,提供类型安全的 SQL 模式声明、关系型和类 SQL 查询构建器,以及自动生成迁移。其压缩后仅 7.4kb,且无依赖项,支持 PostgreSQL、MySQL 和 SQLite,包括 Neon、Turso 和 Cloudflare D1 等无服务器数据库。
观察检查点和伴随文件
SQLite默认会自动进行检查点,长期读事务可能使WAL持续增长。可在维护窗口查看PRAGMA wal_checkpoint(PASSIVE)结果,不把TRUNCATE当作每次请求必须执行的清理。数据库仍被打开时不要手动删除-wal或-shm文件;备份使用SQLite备份接口。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










