如何配置PbootCMS的数据库？

配置 PbootCMS的数据库主要涉及修改核心配置文件 /config/database.php。PbootCMS默认使用 ‌SQLite‌ 数据库（无需额外配置，上传即用），但也支持 ‌MySQL/MariaDB‌。

以下是针对不同数据库类型的详细配置步骤：
一、 核心配置文件位置

所有数据库配置均在网站根目录下的 ‌/config/database.php‌ 文件中进行。
二、 方案 A：使用 SQLite数据库（推荐新手/虚拟主机）

这是 PbootCMS 的默认模式，无需创建数据库账号，适合小型网站或虚拟主机环境。

‌检查 PHP扩展‌：确保服务器已开启 pdo_sqlite 和 sqlite3 扩展。如果访问首页提示“未检测到 sqlite3 扩展”，需在 php.ini 中启用或联系服务商开启。
‌配置代码示例‌：
打开 /config/database.php，确保配置如下（注意注释掉 MySQL 相关行）：

php
return array(
‘database’ => array(
‘type’ => ‘sqlite’, // 驱动类型设为 sqlite
‘host’ => ‘127.0.0.1’,
‘user’ => ”,
‘passwd’ => ”,
‘port’ => ‘3306’,
// ‘dbname’ => ‘pbootcms’, // 确保此行被注释掉
‘dbname’ => ‘/data/pbootcms.db’ // 启用 SQLite，路径通常指向 data 目录下的 .db 文件
)
);

‌权限设置‌：
确保 /data/ 目录（或配置中指定的数据库文件所在目录）具有‌写入权限‌（Linux 下建议设置为 755 或 775）。
如果提示“数据库目录写入权限不足”，请检查该目录权限。

三、 方案 B：使用 MySQL 数据库（推荐生产环境/独立服务器）

适合对性能有要求、数据量较大或使用独立服务器/VPS 的用户。
1. 前期准备

‌创建数据库‌：在宝塔面板、phpMyAdmin 或命令行中创建一个空的 MySQL 数据库。
‌记录信息‌：记下数据库名、用户名、密码、主机地址（通常为 localhost 或 127.0.0.1）和端口（默认 3306）。
‌导入数据‌：
找到源码包中的 /static/backup/sql/ 目录。
将对应的 .sql 文件（如 pbootcms.sql）导入到你新建的空数据库中。
注意：如果是全新安装且程序会自动建表，可跳过导入步骤，但建议手动导入以确保初始数据结构完整。

2. 修改配置文件

打开 /config/database.php，修改如下：

php
return array(
‘database’ => array(
‘type’ => ‘mysqli’, // 【关键】驱动类型改为 mysqli
‘host’ => ‘127.0.0.1’, // 数据库地址，本地通常为 127.0.0.1 或 localhost
‘user’ => ‘你的数据库用户名’, // 填写实际用户名
‘passwd’ => ‘你的数据库密码’, // 填写实际密码
‘port’ => ‘3306’, // 数据库端口
‘dbname’ => ‘你的数据库名’, // 【关键】去掉前面的注释符号 //，填写实际数据库名
// ‘dbname’ => ‘/data/pbootcms.db’ // 确保 SQLite 的这行被注释掉
)
);

3. 常见坑点排查

‌连接失败‌：检查 host 是否正确。某些虚拟主机强制使用 localhost，而有些服务器需用 127.0.0.1。
‌扩展未开启‌：确保 PHP 已开启 pdo_mysql 和 mysqli 扩展。
‌字符集问题‌：建议数据库字符集设置为 utf8mb4，以支持 Emoji 等特殊字符。

四、 从 SQLite 迁移到 MySQL（或反之）

如果你已经使用 SQLite 运行了一段时间，想切换到 MySQL：

‌备份数据‌：在 PbootCMS 后台 -> “系统管理” -> “数据库管理” -> “备份数据库”，下载 SQL 文件。
‌修改配置‌：按照“方案 B”修改 /config/database.php 为 MySQL 配置。
‌导入数据‌：将备份的 SQL 文件导入新的 MySQL 数据库。
注意：如果直接切换配置而不导入数据，网站将变为空白初始状态。
‌清理缓存‌：删除 /runtime/ 目录下的所有文件（除 index.html 外），强制系统重新生成缓存。

五、 验证配置是否成功

清除浏览器缓存。
访问网站首页，看是否正常显示。
访问后台（/admin.php 或你重命名后的文件），尝试登录。
如果页面空白或报错，请查看 /runtime/log/ 目录下的日志文件，根据错误信息调整配置。

‌安全提示‌：配置完成后，建议将 /config/database.php 的文件权限设置为 644（只读），以防止被恶意篡改。