系统安装部署（Nginx + PHP 8.2 + MySQL 5.7）

一、运行环境要求

本系统为 PHP 程序，推荐 Nginx + PHP 8.2 + MySQL 5.7（utf8mb4） 组合，常配宝塔面板管理。

在宝塔「软件商店」安装上述软件，PHP 扩展在「设置 → 安装扩展」中勾选；缺少 pdo_mysql 会导致安装页报错。

二、上传程序并设置权限

把程序包解压到站点根目录（形如 /www/wwwroot/你的域名），确认入口 index.php 位于根目录：

index.php    # 唯一入口，负责分发
app/         # front 前台、admin 后台、model 模型
core/        # Db、Router、Template、Auth 等核心类
template/    # pc 电脑端与 wap 手机端模板
company/     # 商家站模板
config/      # 配置与 routes.php 路由规则
install/     # 安装向导，及 data、upload 数据与附件目录

目录属主改为 Web 运行用户，权限用 755，不要设成 777：

chown -R www:www /www/wwwroot/你的域名
chmod -R 755 /www/wwwroot/你的域名

若你此前用 IIS，请改用 Nginx 写法：重写与权限改由伪静态规则和文件属主控制。

三、创建数据库

在面板「数据库」中新建库并选 utf8mb4，也可用命令行创建：

CREATE DATABASE kfdb DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER 'kfdb'@'localhost' IDENTIFIED BY '替换为高强度密码';
GRANT ALL PRIVILEGES ON kfdb.* TO 'kfdb'@'localhost';
FLUSH PRIVILEGES;

四、运行安装向导

浏览器访问 http://你的域名/install/，填写数据库地址、库名、账号密码，连接通过后设置站点名称与管理员账号，提交即写入配置并初始化 81 张 kf_ 前缀数据表。

安装完成后务必删除或重命名 install/ 目录，避免被再次执行覆盖数据。

五、配置伪静态

在站点「伪静态」中写入分发规则，让 index.php 接管所有请求：

location / {
    try_files $uri /index.php?__route=$uri&$args;
}

规则需与 config/routes.php 配合。保存后访问首页与详情页，URL 不带 index.php 也能打开即已生效；若详情页 404，多为规则未加载，重载 Nginx 即可。

六、后台入口与安全加固

• 后台默认入口为 /admin，上线前建议改名或限制访问来源。
• 确保 autoindex off;，避免目录被直接浏览。
• 删除安装包与测试文件，开启站点文件与数据库的定期备份。

七、上线前检查

首页、列表、详情、发布与后台登录逐一实测；手机端确认切换 wap 模板；上传测试图，确认 upload 可写。