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（当前工作目录下）。
立即学习“PHP免费学习笔记（深入）”；
- 永远用绝对路径：
'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 不报错，只默默变慢或锁表。
