php 8.2 连不上 sqlite,90% 是 pdo_sqlite 扩展未加载;需运行 php -m | grep sqlite 确认输出含 pdo_sqlite,而非仅 sqlite3,并检查 php.ini 中 extension=pdo_sqlite 已启用、路径正确、web 与 cli 配置一致,重启服务后 phpinfo() 中 pdo drivers 必须显示 sqlite。

PHP 8.2 项目连不上 SQLite,90% 是 pdo_sqlite 扩展根本没加载,不是代码写错了。
pdo_sqlite 扩展是否真在运行中?
别只看 php.ini 里有没有那行配置——得确认它实际生效了。PHP 8.2 默认不自动启用该扩展,即使编译时带了,也得手动开。
- 运行
php -m | grep sqlite,如果输出里只有sqlite3没有pdo_sqlite,说明 PDO 驱动压根没起来 - 检查
php.ini(用php --ini确认路径),必须有且仅有一行未注释的:extension=pdo_sqlite - Windows 用户注意:不是
php_pdo_sqlite.dll就是错的,PHP 7.4+ 统一用pdo_sqlite;Linux/macOS 通常是pdo_sqlite.so,但名字由编译决定,extension_dir路径要对 - 重启 Web 服务器或 PHP-FPM 进程,
phpinfo()页面里搜 “PDO drivers”,必须看到sqlite在列表里
new PDO('sqlite:xxx') 报 “could not find driver”
这个错误只说明 PDO 根本不认识 sqlite 协议,和数据库文件路径、权限、是否存在都无关。它发生在连接前的驱动解析阶段。
- 常见误操作:只开了
sqlite3扩展(支持new SQLite3()),但没开pdo_sqlite——这两个是独立扩展,不能互相替代 - 如果你用的是 Docker 或 Alpine 镜像,
apk add php82-pdo-sqlite这类包名必须显式安装,基础镜像通常不带 - CLI 和 Web SAPI 的 php.ini 可能不同:
php -i | grep 'Loaded Configuration File'和phpinfo()输出的路径要分别核对
连接后插入数据查不到,其实是连到了空库
路径写错不会报错,PDO 会静默创建一个新空文件。你以为在操作 data/app.db,其实连的是 ./app.db(当前工作目录下)。
- 永远用绝对路径:
'sqlite:' . __DIR__ . '/data/app.db',别依赖相对路径或getcwd() - 检查文件是否真被创建出来了:
ls -l data/app.db,如果大小是 0 字节,基本就是路径错了 - Web 服务器用户(如
www-data)必须对data/目录有写权限:chmod 755 data/ && chown www-data:www-data data/ - SQLite 不校验数据库结构,
INSERT INTO users表不存在也不会立刻报错,直到你SELECT或执行PRAGMA table_info(users)才暴露问题
查 SQLSTATE[HY000] 错误时看不到具体原因
PDO 默认把底层 SQLite 错误吞掉了,只扔个笼统异常。必须主动开调试开关才能定位真实问题。
- 创建 PDO 时必须加选项:
new PDO($dsn, null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, PDO::ATTR_EMULATE_PREPARES => false]) - 捕获异常后,用
$pdo->errorCode()和$pdo->errorInfo()拿到 SQLite 原生错误码和消息,比如SQLITE_ERROR: no such table或SQLITE_CONSTRAINT: UNIQUE constraint failed - 字段名含短横线(
user-id)或空格,必须用反引号包裹:INSERT INTO users (`user-id`) VALUES (?),否则直接语法错
最常被忽略的一点:WAL 模式下产生的 -wal 和 -shm 文件必须和主库在同一个挂载点,跨分区就会退化回阻塞模式,但 PDO 不报错,只默默变慢或锁表。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











