数据库安装与配置

系统支持 MySQL 与 PostgreSQL。首次安装由 /install 向导完成连接检测、建库（如不存在）、表结构导入和 config/think-orm.php 写入。

安装步骤

1. 部署代码和 Composer 依赖后，访问 /install。
2. 选择数据库类型，填写主机、端口、账号、密码与数据库名。
3. 安装向导检查 PHP PDO 驱动、目标端口和数据库状态。
4. 导入对应表结构，随后创建管理员、首个商户与首个超级管理员客服。

数据库类型	PHP 驱动	初始化脚本
MySQL	pdo_mysql	99kf-install.sql
PostgreSQL	pdo_pgsql	99kf-install.pgsql.sql

覆盖安装会清空现有数据

当目标数据库不为空时，安装向导默认拒绝继续。只有显式选择覆盖后才会导入；覆盖后的既有数据无法由系统恢复。请先完成数据库备份。

连接配置

安装完成后，连接位于 config/think-orm.php，使用中性的 default 连接名：

return [
    'default' => 'default',
    'connections' => [
        'default' => [
            'type' => 'mysql', // 或 pgsql
            'hostname' => '<数据库主机>',
            'database' => '<数据库名>',
            'username' => '<数据库用户>',
            'password' => '<数据库密码>',
            'hostport' => '3306',
            'charset' => 'utf8mb4',
        ],
    ],
];

改动配置后，重启或 reload 应用进程使新连接生效。不要在浏览器代码、前端构建产物或接口请求中暴露数据库凭据。

备份建议

至少备份以下两类数据：

对象	原因
业务数据库	包含商户、客服、访客、会话、消息和系统配置。
public/upload/	聊天图片、文件、头像及其他公开资源存放目录。

数据库恢复与文件恢复应使用同一时间点的备份，以避免消息记录与附件引用不一致。

升级注意事项

不要只执行其中一种数据库的 SQL。MySQL 和 PostgreSQL 分别维护对应方言的安装脚本；升级或定制前，应针对实际使用的数据库类型审查 SQL，再在备份环境验证后应用到生产。