PHP连接SQLite只需启用sqlite3扩展，用SQLite3类直接操作；需确认扩展已加载、路径可写、正确建表；支持参数化查询和事务控制，建议开启WAL模式提升并发性能。
PHP 连 SQLite 非常简单——只要 PHP 编译时启用了 sqlite3 扩展（默认几乎都开启），不用装驱动、不用配服务、不用起进程，直接 new 一个 SQLite3 实例就能读写。
确认 sqlite3 扩展已启用
很多新手卡在这步：不是代码写错，而是扩展根本没加载。运行 php -m | grep sqlite，看到 sqlite3 就行；如果没输出，说明扩展未启用。
- Linux（apt）：
sudo apt install php-sqlite3，然后重启 web 服务或 PHP-FPM -
macOS（Homebrew + PHP）：
brew install php@8.2-sqlite3（版本按需替换），再检查extension=sqlite3.so是否在php.ini中被取消注释 - Windows：打开
php.ini，确保extension=php_sqlite3.dll这行前面没有分号 - 用
var_dump(extension_loaded('sqlite3'));在脚本里验证，返回true才算到位
用 SQLite3 类创建连接并建表
SQLite3 是 PHP 内置类，不依赖 PDO，语法直白。注意：路径必须可写，否则会报 Unable to open database: unable to open database file。
- 数据库文件路径建议用绝对路径，比如
/var/www/db/app.db或__DIR__ . '/data/app.db' - 首次 new
SQLite3会自动创建文件，但父目录必须存在且 Web 服务器用户（如 www-data）有写权限 - 建表语句里别漏掉主键，否则后续 insert 可能静默失败（尤其用
lastInsertRowID()时）
$db = new SQLite3(__DIR__ . '/app.db');
$db->exec("CREATE TABLE IF NOT EXISTS users (
id INTEGER PRIMARY KEY,
name TEXT,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
)");
插入和查询数据的常见写法
SQLite 支持参数化查询，但 SQLite3::prepare() 返回的是 SQLite3Stmt，得手动 bindValue() + execute()，比 PDO 略啰嗦。不推荐拼接 SQL 字符串，哪怕只是测试——容易被注入或引号搞崩。
立即学习“PHP免费学习笔记（深入）”；
- 插入后想取自增 ID，用
$db->lastInsertRowID()，不是mysqli_insert_id()那套 - 查询结果是
SQLite3Result对象，用fetchArray(SQLITE3_ASSOC)获取关联数组，SQLITE3_NUM得到数字索引 - 执行失败时
exec()返回false，但不会抛异常；可用$db->lastErrorMsg()拿错误信息
$stmt = $db->prepare("INSERT INTO users (name) VALUES (:name)");
$stmt->bindValue(':name', 'Alice', SQLITE3_TEXT);
$stmt->execute();
$result = $db->query("SELECT * FROM users WHERE id = 1");
while ($row = $result->fetchArray(SQLITE3_ASSOC)) {
echo $row['name'];
}
关闭连接与事务控制要点
SQLite 是嵌入式数据库，没有“连接池”概念，close() 不是必须调用，但显式关闭能让文件锁及时释放，尤其在 CLI 脚本或高并发写场景下更稳妥。
- 事务用
beginTransaction()/commit()/rollback()包裹，避免多条写操作中间出错导致数据不一致 - SQLite 默认是 AUTOCOMMIT 模式，每条
exec()都单独提交；不加事务的话，10 次 insert 就是 10 次磁盘刷写，性能差 - 不要在事务中混用
exec()和prepare()，容易因内部状态不同步引发database is locked
最易被忽略的一点：SQLite 的 WAL 模式（提升并发读写）需要手动开启，且只对新连接生效——$db->exec("PRAGMA journal_mode = WAL") 最好放在 new 之后立即执行。