当前位置：首页 > 文章列表 > 文章 > php教程 > 宝塔PHP支持哪些数据库？MySQL与SQLite配置说明

宝塔PHP支持哪些数据库？MySQL与SQLite配置说明

2026-05-20 14:44:00 0浏览收藏

宝塔面板中的PHP支持MySQL与SQLite数据库，但二者本质迥异：MySQL是服务型关系数据库，SQLite是嵌入式文件型数据库，它们既不能跨库事务联动，也无法自动语法兼容，所谓“联动”实为应用层手动管理多数据源；配置关键在于确保PHP已启用mysqli、pdo_mysql、pdo_sqlite和sqlite3扩展，并严格注意DSN写法（SQLite必须用绝对路径且赋予www用户读写权限）、框架迁移适配（如Laravel需改写JSON字段为text、ThinkPHP需动态切换驱动）以及并发陷阱（SQLite的文件锁在高并发下极易报错），切勿将SQLite当作MySQL的简易替代品用于生产环境。

宝塔PHP支持哪些数据库搭配_MySQL与SQLite联动配置【说明】

宝塔面板里 PHP 能连哪些数据库

宝塔本身不决定 PHP 支持哪些数据库，关键看它所安装的 PHP 版本是否启用了对应扩展。常见组合中，mysqlnd（MySQLi / PDO MySQL）、pdo_sqlite、sqlite3 这三者默认在宝塔一键部署的 PHP 环境中基本都已启用——但不是绝对，得手动确认。

容易被忽略的是：PHP 8.0+ 默认不再带 mysql（旧 mysql_* 函数），仅保留 mysqli 和 PDO MySQL；SQLite 方面，pdo_sqlite 和 sqlite3 扩展需同时开启才能完整支持 PDO::sqlite 和 SQLite3 类。

进宝塔 → 网站 → PHP 设置 → “配置文件” 旁点“安装扩展”，勾选 mysqli、pdo_mysql、pdo_sqlite、sqlite3
扩展装完后务必点“重载配置”，否则 PHP-FPM 不会加载新模块
用 php -m | grep -E 'mysql|sqlite' 在终端验证是否生效

MySQL 与 SQLite 共存时的 PDO DSN 写法区别

同一套 PHP 代码里要切换 MySQL 和 SQLite，靠的是 PDO 构造时传入不同的 DSN（Data Source Name）。两者语法差异明显，写错一个字符就会报 PDOException: could not find driver 或 invalid data source name。

典型错误是把 SQLite 的路径写成相对路径（如 sqlite:app.db），而 PHP 运行用户（通常是 www）没有当前工作目录读写权限，导致连接失败。

MySQL DSN 示例：mysql:host=127.0.0.1;port=3306;dbname=test;charset=utf8mb4
SQLite DSN 示例：sqlite:/www/wwwroot/example.com/app.db（必须是绝对路径，且 www 用户有读写权限）
别用 sqlite:./app.db 或 sqlite:app.db，PHP 工作目录不可控
SQLite 文件所在目录需 chown www:www 并设为 755，文件设为 644（首次写入时可能需要 664）

在 Laravel / ThinkPHP 等框架中切换数据库驱动的实际操作

框架抽象了底层连接，但切换 MySQL ↔ SQLite 不只是改配置项那么简单。Laravel 的 DB_CONNECTION 设为 sqlite 后，迁移命令 php artisan migrate 会尝试建表，但 SQLite 不支持部分 MySQL 语法（如 JSON 字段、AUTO_INCREMENT 多字段、ENGINE=InnoDB），直接报错。

ThinkPHP 的 database.php 中若同时配了 type 为 mysql 和 sqlite，运行时只能生效一个——靠环境变量或条件判断切换，不能“联动”自动选。

Laravel：SQLite 迁移前先清空 database/migrations/ 中含 MySQL 专属语法的语句（如 $table->json() 改成 $table->text()）
ThinkPHP：用 Env::get('database.type') 动态读取配置，避免硬编码
不要指望框架自动转换 SQL 方言，SQLite 就是轻量嵌入式库，不是 MySQL 替代品
测试阶段用 SQLite 快，上线必须切回 MySQL，别共用同一套 migration