phpEnv不提供SQLite扩展安装，需确认当前PHP版本已启用pdo_sqlite或sqlite3扩展；路径须用绝对路径或__DIR__拼接，避免相对路径导致操作错误文件；PDO连接应设置ATTR_EMULATE_PREPARES=>false并结合errorCode()诊断真实错误。
phpEnv 本身不提供 SQLite 扩展安装功能，它只是 PHP 版本管理器；SQLite 支持取决于你当前启用的 PHP 版本是否已编译或加载了 pdo_sqlite 或 sqlite3 扩展。 大多数 phpEnv 预编译的 PHP 版本（尤其是 7.4+ 和 8.x）默认已内置这两个扩展，但需手动确认并启用——否则 new PDO('sqlite:db.db') 或 new SQLite3('db.db') 会直接报错。
检查当前 PHP 是否已加载 SQLite 扩展
在终端中执行以下命令，确认扩展状态：
- 运行
php -m | grep -i sqlite，应至少看到pdo_sqlite或sqlite3（推荐两者都存在） - 若无输出，说明扩展未启用；不要假设“phpEnv 自带就等于可用”
- 进一步验证：
php -r "var_dump(extension_loaded('pdo_sqlite'));"返回bool(true)才算真正就绪 - Windows 用户注意：phpEnv 的 PHP 二进制包通常使用
php_pdo_sqlite.dll，需检查对应php.ini中该行未被注释
启用扩展：修改 phpEnv 管理的 php.ini
phpEnv 每个 PHP 版本都有独立的配置文件，路径类似 ~/.phpenv/versions/8.2.10/etc/php.ini（Linux/macOS）或 C:\phpenv\versions\8.2.10\etc\php.ini（Windows）。编辑它：
- 取消注释这两行（去掉前面的分号）：
extension=pdo_sqlite和extension=sqlite3 - Windows 下确保
extension_dir指向正确的 dll 目录，例如extension_dir = "ext" - 保存后，用
phpenv rehash刷新，并重启 Web 服务（如 Apache/Nginx）或 CLI 环境 - 再次运行
php -m | grep sqlite验证——改完 ini 不重启进程是无效的
连接 SQLite 时路径错误导致“库凭空消失”
这是 phpEnv 用户最常踩的坑：你以为连上了已有数据库，其实 PDO 或 SQLite3 自动创建了一个同名空文件。根本原因是相对路径受当前工作目录（getcwd()）影响，而 phpEnv 启动的 CLI 或 Web 环境 cwd 往往不是你预期的位置。
立即学习“PHP免费学习笔记（深入）”；
- 绝对路径最可靠：
new PDO('sqlite:/full/path/to/app.db') - 用
__DIR__拼接（适合脚本内）：'sqlite:' . __DIR__ . '/data/app.db' - 避免写成
'sqlite:app.db'或'sqlite:./app.db'—— 这类写法在 Web 请求中可能指向/var/www/html，在 CLI 中可能指向/home/user，完全不可控 - 检查文件权限：Web 服务器用户（如
www-data）必须对.db文件及其父目录有读写权限，否则报unable to open database file
PDO 连接失败却只报 General error？开调试拿真实错误码
PDO::ERRMODE_EXCEPTION 只让异常抛出来，但默认不暴露 SQLite 底层错误细节。你看到 SQLSTATE[HY000]: General error，实际可能是表不存在、字段名含短横线没加反引号、或 datetime 函数不支持。
- 创建 PDO 时务必加这个选项：
PDO::ATTR_EMULATE_PREPARES => false，否则错误信息会被掩盖 - 捕获异常后，用
$e->getMessage()+$pdo->errorCode()+$pdo->errorInfo()三者结合看 - 典型真凶：
INSERT INTO logs (user-id) VALUES (?)中user-id必须写成`user-id`；否则 SQLite 解析失败，PDO 却只报 General error - 别依赖
$pdo->getAttribute(PDO::ATTR_DRIVER_NAME)查驱动名——它返回sqlite，不是错误码
真正麻烦的从来不是“怎么连”，而是“连上之后你以为在操作 A 文件，其实操作的是 B 文件”，或者“语法明明对，就是不报具体哪错了”。路径和错误诊断这两块，比写 SQL 本身更值得花时间盯紧。
