pbootcms如何从SQLite迁移到MySQL

将 PbootCMS 从默认的 SQLite 数据库迁移到 MySQL 数据库，主要分为‌数据导出与转换‌、‌MySQL 环境准备‌、‌配置文件修改‌以及‌验证测试‌四个阶段。由于 SQLite 和 MySQL 在语法和字段类型上存在差异，直接导入往往会导致错误，因此需要特别注意数据格式的兼容性。

以下是详细的操作教程：
第一阶段：备份与准备（至关重要）

‌备份现有数据‌：
找到网站根目录下的 /data/ 文件夹。
复制其中的 .db 文件（如 pbootcms.db）到本地电脑或其他安全位置。这是你的救命稻草，一旦迁移失败可立即恢复。
‌准备 MySQL 环境‌：
确保服务器已安装 MySQL（版本建议 5.7+ 或 8.0）。
创建一个新的空数据库（例如命名为 pbootcms_db）。
记录数据库主机地址（通常为 localhost 或 127.0.0.1）、用户名、密码和端口（默认 3306）。

第二阶段：数据迁移（三种方法任选其一）
方法一：使用专业工具自动迁移（推荐，最稳妥）

使用支持多数据库管理的工具（如 ‌Navicat Premium‌、‌DBeaver‌ 或 ‌SQLiteStudio plus MySQL插件‌）可以自动处理大部分字段类型映射问题。

‌连接双库‌在工具中同时建立 SQLite 连接（指向本地的 .db file）和 MySQL 连接（指向服务器上的空库）。
‌数据传输‌：
选中 SQLite 数据库中的所有表。
右键选择“数据传输”或“导出到 MySQL”。
‌关键设置‌：在映射选项中，确保 INTEGER PRIMARY KEY AUTOINCREMENT 被正确映射为 MySQL 的 INT AUTO_INCREMENT PRIMARY KEY。
执行传输，等待完成。

方法二：手动导出 SQL 并修正（适合无图形化工具时）

如果只能使用命令行或简单工具，需手动处理语法差异。

‌导出 SQLite 数据‌：
使用 SQLiteStudio 或 DB Browser for SQLite打开 .db` 文件。
选择所有表，导出为 .sql 文件。
‌注意‌：导出时编码选择 UTF-8。
‌修正 SQL 脚本（关键步骤）‌：
用文本编辑器打开导出的 .sql 文件。
‌替换自增主键语法‌：将 AUTOINCREMENT 全部替换为 AUTO_INCREMENT。
‌调整字段类型‌：
SQLite 的 TEXT 建议改为 MySQL 的 VARCHAR(255) 或 LONGTEXT（根据内容长度）。
SQLite 的 INTEGER 改为 INT。
SQLite 的时间字段若为 TEXT，建议在 MySQL 中建表时改为 DATETIME 或 TIMESTAMP。
‌移除不兼容语句‌：删除文件头部的 BEGIN TRANSACTION; 和尾部的 COMMIT;（MySQL 导入时通常不需要或处理方式不同，视导入工具而定，phpMyAdmin 通常能自动处理，但命令行导入建议保留或去掉需测试）。
‌引号处理‌：SQLite 常用双引号标识字段，MySQL 偏好反引号 `。如果报错，需批量替换。
‌导入 MySQL‌：
登录 phpMyAdmin 或使用命令行：

bash
mysql -u 用户名 -p 数据库名 < 修正后的.sql文件

方法三：使用官方初始结构 + 后台重新录入（仅适用于数据量极小）

如果网站刚搭建，数据很少，可以直接忽略旧数据，按照“全新安装 MySQL 版”的步骤，导入 PbootCMS 安装包 /static/backup/sql/ 下的官方 SQL 文件，然后在后台重新添加内容。此方法不适用于已有大量数据的站点。
第三阶段：修改 PbootCMS 配置文件

数据导入成功后，需要告诉 PbootCMS 切换到 MySQL。

打开网站根目录下的 /config/database.php 文件。
修改配置数组，参考如下模板（请替换为你自己的真实信息）：

php
return array(
‘database’ => array(
‘type’ => ‘mysqli’, // 【关键】驱动类型，尝试 mysqli 或 pdo_mysql
‘hostname’ => ‘127.0.0.1’, // 数据库地址
‘username’ => ‘你的MySQL用户名’,
‘password’ => ‘你的MySQL密码’,
‘hostport’ => ‘3306’, // 端口
‘dbname’ => ‘你的数据库名’, // 【关键】填写新建的数据库名
‘prefix’ => ‘ay_’, // 表前缀，默认为 ay_，请检查导入后的表前缀是否一致
‘charset’ => ‘utf8mb4’ // 字符集，建议 utf8mb4 以支持 emoji
)
);

注意：PbootCMS 不同版本的配置键名可能略有差异（如 host vs hostname），请以你当前版本 database.php 中的注释或默认结构为准。如果是较新版本，通常只需修改 type, hostname, username, password, dbname 这几项。
第四阶段：清理缓存与验证

‌清除缓存‌：
删除 /runtime/ 目录下的所有文件和文件夹（除了 index.html 如果存在的话，或者干脆清空整个 runtime 目录，系统会自动重建）。
这一步非常重要，否则系统可能仍读取旧的 SQLite 缓存配置。
‌访问测试‌：
打开网站首页，检查栏目、文章是否正常显示。
登录后台（/admin.php），检查内容管理、会员数据等是否完整。
尝试发布一篇新文章，测试写入功能是否正常。
‌排查常见问题‌：
‌空白页/500错误‌：检查 /runtime/log/ 下的日志文件，查看具体报错。常见原因是 PHP 未开启 mysqli 或 pdo_mysql扩展。
‌乱码‌：确保数据库、表、字段的字符集均为 utf8mb4，且网页头部声明也是 UTF-8。
‌连接拒绝‌：检查 hostname 是否正确，防火墙是否放行 3306 端口（如果是远程数据库）。

注意事项

‌表前缀一致性‌：PbootCMS 默认表前缀是 ay_。在导入数据到 MySQL 时，确保表名保留了 ay_ 前缀，并在 database.php 中配置相同的 prefix。
‌gtype 字段‌：部分旧版本迁移时，ay_content 表中的 gtype 字段可能需要重置或检查，确保其值符合当前系统要求。
‌生产环境建议‌：务必先在本地或测试服务器完成迁移验证，确认无误后再在生产服务器操作。