PHP连接SQLite数据库教程

本文详解了PHP连接SQLite数据库的正确实践，明确指出PHP 7.0+已彻底移除过时的sqlite_open()函数，必须改用PDO与pdo_sqlite扩展——这是唯一官方推荐、跨版本兼容且功能完备的方案；文章直击三大高频痛点：扩展未启用导致“driver not found”、路径错误引发静默创建空库、通用SQL错误掩盖真实原因，并给出可落地的解决方案，包括绝对路径拼接、权限配置、异常模式开启、底层SQLite错误码提取以及事务提交与锁处理技巧，助开发者避开陷阱、快速定位并解决真实生产环境中的SQLite连接与操作难题。

PHP 用 sqlite_open() 还是 PDO？选错就踩坑

直接结论：别用 sqlite_open()，它在 PHP 7.0+ 已被移除，连函数都不存在了。现在唯一可靠、跨版本的方式是用 PDO + pdo_sqlite 扩展。

常见错误现象：Fatal error: Uncaught Error: Call to undefined function sqlite_open() —— 这不是你代码写错了，是 PHP 版本升级后直接砍掉了旧 API。

• PDO 是官方推荐路径，支持预处理、事务、异常捕获，SQLite3 也原生兼容
• 确认扩展已启用：extension=php_pdo_sqlite.dll（Windows）或 extension=pdo_sqlite.so（Linux/macOS），可通过 php -m | grep sqlite 验证
• 如果只装了 sqlite3 扩展但没开 pdo_sqlite，new PDO('sqlite:db.db') 会报 could not find driver

连接 SQLite 文件时路径写错，数据库“凭空消失”

SQLite 不是服务端进程，它靠文件路径定位数据库。路径一错，PDO 就自动新建一个空文件——你以为连上了，其实操作的是全新空白库。

典型表现：插入数据后查不到、表结构始终为空、sqlite_master 里啥也没有。

• 绝对路径最稳：new PDO('sqlite:/var/www/myapp/data/app.db')，避免相对路径受 cwd 影响
• 用 __DIR__ 拼接更安全：'sqlite:' . __DIR__ . '/data/app.db'
• 注意权限：Web 服务器用户（如 www-data 或 _www）必须对文件和所在目录有读写权限，否则报 unable to open database file

执行 SQL 报 SQLSTATE[HY000]: General error 怎么查

这个错误太笼统，实际原因几乎全是语法或运行时问题，PDO 默认不暴露具体 SQLite 错误码，得手动开调试。

关键动作：关掉模拟预处理、开启错误抛出，并用 getAttribute() 拿底层 SQLite 错误信息。

• 创建 PDO 时加选项：new PDO($dsn, null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, PDO::ATTR_EMULATE_PREPARES => false])
• 捕获异常后打印详细信息：$e->getMessage() . ' (SQLITE code: ' . $pdo->getAttribute(PDO::ATTR_DRIVER_NAME) . ')' → 实际要用 $pdo->errorCode() 和 $pdo->errorInfo()
• 常见诱因：字段名含空格/短横线没加反引号、INSERT INTO table VALUES (?) 却传了 2 个参数、用 datetime('now') 但 SQLite 版本太老（

用完不关闭连接？其实影响不大，但事务要手动 commit

SQLite 是嵌入式数据库，PDO 连接对象销毁时会自动释放资源，显式调用 $pdo = null 或 unset($pdo) 并非必须。真正容易漏的是事务控制。

现象：执行 BEGIN 后插入几条数据，脚本结束也没报错，但数据就是不落盘。

• SQLite 默认自动提交（autocommit），一旦执行 DML（INSERT/UPDATE）就立即写入；只有显式 BEGIN 后才进入手动事务模式
• 务必配对使用：$pdo->beginTransaction() → 操作 → $pdo->commit()；失败时用 $pdo->rollback()
• 若忘了 commit，连接断开时 SQLite 会回滚未完成事务——不是丢数据，是压根没存进去

复杂点在于：SQLite 的 WAL 模式、busy timeout 设置、以及多进程并发写同一文件时的锁行为，这些不常碰，但真遇到 database is locked 就得回头调 PDO::ATTR_TIMEOUT 和检查是否用了 PRAGMA journal_mode = WAL。

本篇关于《PHP连接SQLite数据库教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！