PHP连接SQLite数据库方法详解

本文详细讲解了PHP连接SQLite数据库的三种主流方法——使用内置SQLite3类、PDO扩展以及已废弃的旧版sqlite扩展，涵盖环境配置、代码实现、安全实践及常见错误排查，帮助开发者快速上手并规避权限、路径、锁表、SQL注入等典型问题，是面向实际开发场景的实用指南。

如果您尝试在PHP中访问SQLite数据库，但无法建立连接或执行查询，则可能是由于扩展未启用、数据库路径错误或权限问题。以下是实现PHP连接并操作SQLite数据库的多种方法：

一、使用SQLite3类（面向对象方式）

SQLite3是PHP内置的原生类，无需额外安装扩展（PHP 5.3.0+默认启用），通过实例化SQLite3对象即可直接打开数据库文件并执行SQL语句。

1、确认php.ini中已启用sqlite3扩展：检查extension=sqlite3未被注释且无分号前缀。

2、创建PHP脚本，使用new SQLite3()初始化连接：数据库文件路径必须为绝对路径或确保当前工作目录可写。

3、调用query()方法执行CREATE TABLE或INSERT语句，例如：$db->query("CREATE TABLE users(id INTEGER, name TEXT)");。

4、使用querySingle()获取单值结果，或query()配合while循环遍历SQLite3Result对象。

5、操作完成后调用close()方法显式关闭数据库连接。

二、使用PDO扩展（数据源统一接口）

PDO提供数据库抽象层，支持多种驱动，SQLite仅需指定sqlite://协议和文件路径，便于后续迁移至其他数据库系统。

1、确认php.ini中已启用pdo与pdo_sqlite扩展：extension=pdo和extension=pdo_sqlite均需启用。

2、构造DSN字符串，格式为"sqlite:/var/www/db/test.db"，路径必须可读写。

3、实例化PDO对象时传入DSN，并设置错误模式为异常：new PDO($dsn, null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);。

4、使用prepare()和execute()执行参数化查询，避免SQL注入；fetch()或fetchAll()获取结果集。

5、PDO连接会在脚本结束时自动释放，但建议显式销毁对象以立即释放资源。

三、使用旧版sqlite扩展（PHP 5.3之前遗留方式）

该扩展在PHP 5.4.0中已被移除，仅适用于维护老旧系统；函数式调用风格，不推荐新项目使用，但需了解其基本结构。

1、确认php.ini中存在extension=sqlite且未被禁用。

2、调用sqlite_open()函数打开数据库文件，返回资源句柄；若文件不存在则自动创建。

3、使用sqlite_query()执行SQL命令，返回结果资源；对SELECT语句需用sqlite_fetch_array()逐行提取。

4、所有操作完成后调用sqlite_close()关闭资源句柄。

5、注意：此扩展不支持预处理语句，易受SQL注入攻击，务必过滤输入。

四、处理常见连接失败场景

当连接失败时，需区分错误类型并针对性修复，而非笼统重启服务。错误信息通常由扩展自身抛出，可通过try-catch或错误回调捕获。

1、报错"unable to open database file"：检查数据库路径是否拼写正确，Web服务器用户（如www-data）对该路径是否有读写权限。

2、报错"no such table"：确认表名大小写与CREATE语句完全一致，SQLite默认区分大小写。

3、报错"database is locked"：多个进程同时写入同一数据库文件，需引入事务控制或改用WAL模式：$db->exec("PRAGMA journal_mode = WAL");。

4、报错"not authorized"：SQLite3对象调用createFunction()等权限敏感方法时，需确认未启用disable_functions限制。

5、报错"could not find driver"（PDO）：确认pdo_sqlite扩展已加载，运行php -m | grep sqlite验证。

到这里，我们也就讲完了《PHP连接SQLite数据库方法详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！