Webman默认不支持SQLite，需手动启用PHP的pdo_sqlite和sqlite3扩展，并在config/database.php中配置绝对路径的database文件，确保runtime目录可写，否则报错Driver [sqlite] not supported。
Webman 默认不带 SQLite 驱动，直接在 config/database.php 里配 'driver' => 'sqlite' 会报 Driver [sqlite] not supported 错误——必须手动安装 PDO SQLite 扩展并确保 PHP 编译时启用了 sqlite3 支持，否则连基础连接都建立不了。
确认 PHP 已启用 sqlite3 扩展
SQLite 不是靠 Composer 包驱动的，而是依赖 PHP 自身的 PDO 模块。很多开发环境（尤其是宝塔、Docker 官方镜像、macOS Homebrew PHP）默认不启用它。
- 执行
php -m | grep sqlite，应看到pdo_sqlite和sqlite3两行；若无，说明扩展未加载 - Ubuntu/Debian 用户补装：
sudo apt install php-sqlite3，然后重启 CLI 或 FPM - CentOS/RHEL 用户：
sudo yum install php-sqlite3或检查/etc/php.d/20-sqlite3.ini是否存在且未被注释 - 宝塔用户：进入 PHP 设置 → 【禁用函数】页确认没禁用
sqlite_open等，再进【安装扩展】页勾选sqlite3 - 验证是否真可用：
php -r "var_dump(class_exists('PDO') && extension_loaded('pdo_sqlite'));"返回bool(true)才算过关
在 config/database.php 中正确配置 SQLite 连接
SQLite 是文件型数据库，host、port、username、password 全部无效，填了反而可能触发底层异常；关键只在 database 路径是否可写、是否绝对路径、目录是否存在。
- 推荐写成绝对路径，避免工作目录切换导致找不到文件：
'database' => runtime_path() . '/database.sqlite' - 务必确保
runtime/目录存在且 Webman 进程有写权限（Linux 下常需chown -R www-data:www-data runtime/） - 删掉所有与 MySQL 冗余的配置项，例如
'charset'、'collation'、'prefix'、'strict'在 SQLite 下无意义，留着可能引发警告 - 最小可用配置示例：
return [
'default' => 'sqlite',
'connections' => [
'sqlite' => [
'driver' => 'sqlite',
'database' => runtime_path() . '/database.sqlite',
'prefix' => '',
],
],
];
首次运行前手动初始化 SQLite 文件
Webman 的 Db 类不会自动创建 SQLite 数据库文件——如果 database.sqlite 不存在，Db::table('users')->get() 会直接抛出 PDOException: unable to open database file。
立即学习“PHP免费学习笔记（深入）”；
- 启动服务前，先在终端执行：
touch runtime/database.sqlite && chmod 644 runtime/database.sqlite - 或者用 PHP 一行命令生成：
php -r "file_put_contents('runtime/database.sqlite', '');" - 更稳妥的做法是在
start.php启动前加检查逻辑（尤其部署到新机器时）：
if (!is_file(runtime_path() . '/database.sqlite')) {
file_put_contents(runtime_path() . '/database.sqlite', '');
}
SQLite 的实际使用限制要心里有数
它轻量、免运维，但不是 MySQL 替代品。Webman 项目一旦需要并发写入、JOIN 复杂查询或外键级联，SQLite 很快会成为瓶颈。
-
INSERT或UPDATE高频写入时，可能遇到database is locked——这不是 Webman 问题，是 SQLite 本身的 WAL 模式未启用或连接未复用所致 - 不支持
ALTER TABLE ... DROP COLUMN，字段变更只能靠导出重建表 - 迁移工具（如 Laravel Migrations 衍生方案）对 SQLite 支持弱，建议小项目用原生 SQL 初始化
- 调试时别依赖
Db::connection('sqlite')->select('EXPLAIN QUERY PLAN ...')，部分版本返回空，得直连sqlite3 runtime/database.sqlite查看
SQLite 配置最常卡在扩展缺失和路径不可写这两步，其他都是次要问题。只要 pdo_sqlite 加载成功、database.sqlite 文件存在且可写，剩下的就是写 SQL 的事了。
