PHP连接SQLite数据库怎么配置-php教程-PHP中文网

php连接sqlite需同时启用sqlite3和pdo_sqlite扩展，sqlite3类与pdo均须用绝对路径，ci4中sqlite3驱动要求database字段为绝对路径且dbdriver严格为“sqlite3”。

php连接sqlite数据库怎么配置

确认php.ini已启用sqlite3和pdo_sqlite扩展

PHP连接SQLite的前提是扩展必须加载成功，缺一不可。只开其中一个会导致连接失败但报错不明确——比如开了 sqlite3 却没开 pdo_sqlite，用PDO方式就会抛出 could not find driver；反之，只开 pdo_sqlite 而没开 sqlite3，某些底层操作（如CodeIgniter4的SQLite3驱动）可能直接静默失败。

检查方法：运行 php --ini 找到配置文件路径，打开 php.ini，确认以下两行未被注释：

extension=sqlite3
extension=pdo_sqlite

Windows下对应文件可能是 php_sqlite3.dll 和 php_pdo_sqlite.dll，Linux/macOS则是 sqlite3.so 和 pdo_sqlite.so。改完必须重启Web服务器或PHP-FPM，否则扩展不会生效。

SQLite3类连接必须用绝对路径，且父目录需可写

PHP原生 SQLite3 类构造函数只接受绝对路径，传入相对路径（如 ./data.db 或 writable/db.sqlite）会触发 Unable to open database: 错误，但不抛异常，容易误判为“连接成功”。

安全拼接路径推荐用 __DIR__ 或 realpath()：

Linux/macOS：$db = new SQLite3(__DIR__ . '/../writable/app.db');
Windows：$db = new SQLite3(__DIR__ . '/writable/app.db');（正斜杠/兼容性更好）

注意：SQLite会自动创建数据库文件，但父目录必须已存在且Web服务器用户（如 www-data、_www）有写权限。常见坑是目录存在但权限为 755，导致文件创建失败。建议设为 755 目录 + 644 文件，首次运行前手动 touch 一下或 chown www-data:www-data writable/。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

PDO连接DSN格式必须是 `sqlite:/绝对路径`

PDO方式更通用，但DSN写法极易出错。错误示例：sqlite:./data.db（相对路径）、sqlite:data.db（缺协议头）、sqlite://data.db（多了一个斜杠）都会导致连接失败。

正确写法只有这一种：

$pdo = new PDO('sqlite:/var/www/myapp/writable/app.db');
$pdo = new PDO('sqlite:' . __DIR__ . '/app.db');

额外建议：

务必设置 $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION)，否则SQL错误会被忽略
首次连接时，如果文件不存在，PDO会自动创建；但若父目录不可写，会抛出 SQLSTATE[HY000] [14] unable to open database file
不要在DSN里加任何查询参数（如 ?mode=rwc），SQLite PDO不支持

CodeIgniter4.6.4中SQLite配置不能填 `database` 字段

CI4的SQLite3驱动是直接调用 new SQLite3($path)，它根本不管DSN或其它字段。但如果你在 app/Config/Database.php 的 public $sqlite = [...] 配置里写了 'database' => 'writable/db.db'，CI4会把这个值当作相对路径传进去，结果就是静默失败——$this->db 看似有对象，但所有查询都返回空。

正确做法：