phpEnv 中 pdo_sqlite 默认已静态编译但 php.ini 中常被注释，需手动取消 extension=pdo 和 extension=pdo_sqlite 的注释并重启服务才能启用。
phpEnv 里 pdo_sqlite 扩展默认是否启用
绝大多数 phpEnv 版本（尤其是 2024 年后发布的）已静态编译 pdo 和 pdo_sqlite，无需手动安装扩展包。但关键点在于：php.ini 中对应行仍可能被注释，导致实际未加载。
运行 php -m | grep pdo_sqlite，若无输出，说明虽已编译进 PHP，但未在运行时启用。
不要假设“装了 phpEnv 就自动支持 SQLite”——必须验证配置生效。
确认并启用 pdo_sqlite 的三步操作
phpEnv 的 php.ini 通常位于 phpenv/php/{version}/etc/php.ini（路径可通过 php --ini 确认）。打开后查找以下两行：
-
extension=pdo—— 必须存在且未被注释（PHP 8.0+ 已默认内置，但旧版需显式启用） -
extension=pdo_sqlite—— 必须取消注释；若整行缺失，手动添加即可 - 确保
extension=sqlite3也启用（PDO 依赖它底层驱动，部分 phpEnv 构建版本会漏掉）
保存后，**必须重启 phpEnv 的 Web 服务进程**（如使用内置 Apache，则执行 phpenv restart；若用 Nginx + PHP-FPM，需 phpenv fpm restart）。仅改配置不重启，等于没改。
连接失败常见原因与快速排查
即使扩展启用，new PDO('sqlite:db.sqlite') 仍报错，大概率是以下之一：
-
SQLSTATE[HY000] [14] unable to open database file：数据库文件路径不可写，或父目录不存在。SQLite 需要对.db文件及其所在目录都有写权限 -
SQLSTATE[HY000] [14] file is encrypted or is not a database：文件已被其他进程独占写入（如另一个 PHP 脚本正持有连接未释放），或文件损坏 - 使用相对路径（如
sqlite:./data.db）时，当前工作目录不固定（CLI 与 Web 请求的getcwd()可能不同），建议一律用__DIR__ . '/data.db'构造绝对路径 - phpEnv 默认禁用
allow_url_fopen，但此设置不影响 SQLite DSN，无需调整
验证 SQLite 支持是否真正就绪
别只信 phpinfo() 页面里有没有模块名。最可靠的方式是跑一段最小验证脚本：
<?php if (!in_array('sqlite', PDO::getAvailableDrivers())) {
die('PDO::getAvailableDrivers() 不含 sqlite —— pdo_sqlite 未加载');
}
try {
$db = new PDO('sqlite:' . __DIR__ . '/test_check.db');
$db->exec('CREATE TABLE t(x)');
echo "✅ 扩展启用 + 路径可写 + 连接成功";
} catch (Exception $e) {
echo "❌ 失败：" . $e->getMessage();
}
这个脚本绕过了所有中间层判断，直击核心能力。只要它通过，后续开发就能放心用；如果失败，错误信息直接指向具体环节（是扩展没启？路径不对？还是权限卡住？）。
注意：SQLite 的并发写入限制很硬，本地开发时别在多个请求中频繁 exec("INSERT") 而不加事务或 WAL 模式，否则容易遇到 database is locked —— 这不是配置问题，是 SQLite 本身的机制。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
