必须启用pdo_sqlite或sqlite3扩展，phpenv仅管理php版本不自带sqlite；路径须用绝对路径或__dir__拼接，权限需确保可读写；pdo连接需设errmode_exception并用errorinfo()查具体错误。
phpEnv 本身不自带 SQLite，它只是 PHP 版本管理工具；能否用 SQLite，完全取决于你当前激活的 PHP 版本是否启用了 pdo_sqlite 或 sqlite3 扩展。没启用就等于“没装”，跟 phpEnv 无关。
确认当前 PHP 是否已加载 SQLite 扩展
phpEnv 切换版本后，扩展配置仍沿用对应 PHP 的 php.ini，必须手动检查。常见错误是：以为换了 PHP 就自动带 SQLite，结果 new PDO('sqlite:db.db') 直接报 could not find driver。
- 运行
phpenv version确认当前激活的 PHP 版本（如8.2.15） - 执行
php -m | grep -i sqlite—— 必须看到pdo_sqlite和/或sqlite3，缺一不可 - 若无输出，说明扩展未启用：找到该版本对应的
php.ini（通常在~/.phpenv/versions/8.2.15/etc/php.ini），取消注释这两行：extension=pdo_sqliteextension=sqlite3 - 改完重启 CLI 环境（关掉终端重开），再跑
php -m验证
连接时路径写错导致“数据库凭空消失”
SQLite 不连服务，只靠文件路径。phpEnv 环境下当前工作目录（cwd）容易变，相对路径极不可靠——new PDO('sqlite:app.db') 很可能在临时目录下建了个空 app.db，而你真正想操作的文件根本没被触碰。
- 绝对路径最稳：
new PDO('sqlite:/home/user/myapp/data/app.db') - 用
__DIR__拼接更安全：'sqlite:' . __DIR__ . '/data/app.db'，确保始终指向项目内固定位置 - 父目录必须存在且可写：Web 服务器用户（如
www-data）或 CLI 当前用户需对data/目录有rwx权限，否则报unable to open database file - 首次连接时文件不存在，PDO 会自动创建；但若目录不可写，就会静默失败或报错
PDO 连接报 SQLSTATE[HY000] 却看不到具体错误
这个错误码太泛，99% 是 SQLite 底层报的语法或运行时问题，但 PDO 默认不透出细节。不打开调试，你永远不知道到底是字段名少加了反引号，还是 datetime('now') 在旧版 SQLite 中不支持。
- 创建 PDO 时必须加选项：
new PDO($dsn, null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, PDO::ATTR_EMULATE_PREPARES => false]) - 捕获异常后，别只打
$e->getMessage()，要调$pdo->errorCode()和$pdo->errorInfo()—— 第三个元素才是 SQLite 原生错误信息 - 典型诱因：
INSERT INTO user-log (name) VALUES (?)中的短横线没用反引号包裹；VALUES (?, ?)却只 bind 一个参数；表名/字段名大小写与实际定义不一致（SQLite 默认大小写敏感）
真正麻烦的不是“怎么连”，而是权限、路径、错误透出这三处细节——它们不会报明确错误，却让数据写不进、查不到、改不了。每次连接失败，先盯死 php -m | grep sqlite 和 $pdo->errorInfo()，比反复改 SQL 有用得多。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
