# 简约论坛系统 **Repository Path**: zjjweb/bbs ## Basic Information - **Project Name**: 简约论坛系统 - **Description**: 一个简约的开源BBS系统 - **Primary Language**: PHP - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-08 - **Last Updated**: 2026-10-08 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 简约社区 · BBS 论坛系统 一套基于 **ThinkPHP 8 + MySQL + Layui** 构建的简约 BBS 社区系统。界面采用卡片式现代简约风格,注重流畅性与易用性,具备完整论坛特性。 ## 技术栈 | 层 | 技术 | |---|---| | 后端框架 | ThinkPHP 8.1.4(单应用模式) | | 数据库 | MySQL 5.7+(表前缀 `bbs_`) | | 模板引擎 | ThinkPHP 内置 Think 模板 | | 前端 | Layui 2.13 + 原生 CSS 变量设计系统 | | PHP 版本 | PHP 8.0+(开发环境 8.2.34) | ## 功能清单 ### 前台 - **首页**:分组版块卡片、每版块最新主题、热门主题侧栏、公告下方「最新动态」(推荐帖图片幻灯片,一屏 6 张自动轮播 + 右侧置顶帖)、底部三栏(社区数据 / 活跃会员 / 新加入) - **版块**:版块总览、版块主题列表(最新/热门/精华/回复排序、分页);版块排布支持后台切换(网格卡片 / 一行一个) - **广告位**:版块页与帖子页自动展示后台配置的广告;帖子页多条广告时随机展示一条 - **主题**:详情页(置顶/精华/锁定标记)、楼层展示、楼中楼引用回复、锚点定位 - **发帖/回帖**:支持 `[b]`/`[img]`/`[quote]` BBCode、`@` 提及、图片上传、编辑主题 - **用户系统**:注册(图形验证码,**新会员需管理员审核通过后才能发帖**)、登录、退出、个人主页(主题/回复/收藏)、资料与密码修改;全站展示用户组徽章(版主/管理员)与会员等级徽章(Lv.1~Lv.6,按积分自动计算) - **会员审核**:新注册会员默认为「待审核」,可登录浏览但禁止发帖/回帖/上传/点赞收藏/签到;后台「用户管理」可一键通过或拒绝,审核通过自动发送站内信通知,前台同步显示审核状态提示条 - **互动**:点赞主题/回复、收藏主题、站内信通知、每日签到 - **搜索**:主题搜索 + 用户搜索 ### 后台(`/admin`) - **数据看板**:用户/主题/回复/版块统计、近 7 天趋势图(内联 SVG)、最新主题与注册 - **版块管理**:增删改、分组归属、图标、主题色、排序、显示/隐藏 - **分组管理**:版块分组的增删改、排序、显示/隐藏(隐藏分组时其下版块一并隐藏)、分组下版块明细 - **主题管理**:搜索筛选、置顶/精华切换、软删除 - **回复管理**:搜索、软删除并自动维护回复数 - **用户管理**:新增/编辑用户(昵称、邮箱、头像上传、签名、性别、用户组、积分、金币、状态、禁言、重置密码)、搜索筛选(关键词/用户组/状态)、用户概览统计(含待审核数)、**待审核会员置顶展示 + 「通过审核 / 拒绝」快捷操作**;封禁/解封、禁言/解除、重置密码快捷操作 - **会员等级与用户组**: - 用户组(`bbs_user.group_id`):`1 普通会员` / `2 版主` / `3 管理员` / `9 超级管理员`,后台编辑用户时直接指定,前台以彩色徽章展示(普通会员不显示徽章) - 会员等级(按积分自动计算,无需手动维护):`Lv.1 新手上路` ≥0 分、`Lv.2 注册会员` ≥50 分、`Lv.3 中级会员` ≥200 分、`Lv.4 高级会员` ≥500 分、`Lv.5 资深会员` ≥1000 分、`Lv.6 论坛元老` ≥3000 分;等级定义集中在 `app/common.php` 的 `user_levels()`,前台帖子列表/详情、个人主页、会员列表、搜索结果、顶部导航同步展示 - **附件管理**:预览、物理删除 - **广告管理**:增删改、启用/停用;投放位置(版块页/帖子页/全站)、类型(图片/文字链接/纯 HTML)、投放时间窗、排序、展示/点击统计;帖子页多条广告随机展示 - **系统设置**:站点信息、前台版块显示方式(一排多个 / 一行一个)、注册开关、发帖间隔、分页、上传限制、签到积分、活跃会员显示数量(首页卡片,默认 3 个)、ThinkPHP 调试模式开关(写入根目录 `.env` 的 `APP_DEBUG`,保存即生效);修改管理员密码 - **版权与备案**:版权信息(支持建站年份区间)、工信部备案号 + 查询链接、公安网备号 + 查询链接(自动带盾牌图标)、页脚附加说明(免责声明等,支持换行)、底部技术标识开关、客服 QQ / 微信 / 邮箱;设置页提供页脚实时预览,配置后自动展示在前台页脚 - **安全管理**:内置 9 大类 500+ 敏感词库(国家领导人 / 政治敏感 / 色情低俗 / 辱骂 / 广告引流 / 赌博毒品 / 违法犯罪 / 暴恐 / 其他,可分类启停 + 自定义追加),命中后自动进入人工审核(或直接拒绝);防灌水机制(发帖间隔、新号冷却、重复内容判定、每小时 / 每日上限、最少字数、重复字符拦截、链接数限制);新会员注册企业微信机器人提醒(Webhook 仅允许官方域名,支持测试推送) - **数据备份**:纯 PHP 导出 / 还原(不依赖 mysqldump 与 exec,虚拟主机可用),支持 gzip 压缩、仅结构备份;备份文件存于 `runtime/backup/`,支持上传 / 下载 / 删除;还原前自动生成当前数据快照便于回退,同名表先删后建避免中断,流式解析 SQL 语句(引号 / 注释安全);仅超级管理员可操作,文件名白名单校验防目录穿越 ## 目录结构 ``` zjjbbs/ ├── app/ │ ├── controller/ 前台控制器 │ │ ├── Base.php 全局模板变量 │ │ ├── Index.php 首页/版块/主题/聚合/搜索 │ │ ├── Auth.php 登录注册验证码 │ │ ├── Post.php 发帖回帖点赞收藏上传 │ │ ├── User.php 个人中心 │ │ └── admin/ 后台控制器 │ ├── admin/ │ │ ├── middleware/Auth.php 后台登录校验 │ │ └── view/ 后台视图 │ ├── model/ User/Forum/Thread/Post 等模型 │ ├── view/ 前台视图(layout/common/index/auth/post/user) │ └── common.php 全局助手函数 ├── config/ 配置(database/session/route/view 等) ├── docs/ │ ├── install.sql 建表脚本 │ ├── init.sql 初始化数据(管理员、设置、版块示例) │ └── demo.sql 演示数据(带数据安装用) ├── public/ │ ├── index.php 入口 │ ├── install/ 安装向导(安装完成后建议删除) │ │ ├── index.php 向导入口(原生 PHP,不依赖框架) │ │ ├── lib.php 环境检测 / 大小写检测 / SQL 导入 │ │ ├── data/*.sql 结构 + 基础数据 + 演示数据 │ │ └── install.lock 安装锁(安装后生成) │ ├── static/layui/ Layui 资源 │ ├── static/bbs/css/ 前台 + 后台样式 │ └── storage/ 上传文件目录 └── route/app.php 路由定义 ``` ## 安装部署 ### 方式一:安装向导(推荐) 把整站上传到服务器后,浏览器访问安装向导即可完成部署,**全程无需手动建库、改配置**: 1. **上传**:将整个项目上传到服务器(如宝塔 `/www/wwwroot/bbs`),站点根目录指向 `public/`; 2. **访问安装向导**: - Web 根 = `public` → `http://你的域名/install/` - Web 根 = 项目根 → `http://你的域名/install.php`(自动跳转) 3. **按向导完成 5 步**: - **环境检测**:PHP 版本、扩展、目录权限,以及 **Linux 大小写兼容检测**(详见下文); - **数据库配置**:填入主机/库名/账号,支持勾选「数据库不存在时自动创建」,可一键「测试连接」,可自定义表前缀; - **站点设置**:站点名称、公告、管理员账号密码; - **选择安装模式**: - **全新安装** —— 仅建表 + 必要基础数据(系统设置、版块、管理员),适合正式上线; - **带数据安装** —— 额外导入演示会员、主题、回复、站内消息、广告位(演示会员统一密码 `123456`),适合体验与演示; - **执行安装**:逐步显示进度与日志(写 `.env` → 建库 → 建表 → 导数据 → 写管理员 → 生成安装锁)。 4. **完成后**:按页面提示**删除 `public/install/` 目录**。安装程序会在目录内生成 `install.lock` 锁文件,即使不删除也无法重复安装;此外若检测到 `.env` 指向的数据库中已存在同前缀数据表,向导同样会自动拦截,双重防止误覆盖线上数据。 > 安装程序(`public/install/`)为**纯原生 PHP + PDO** 实现,不依赖 ThinkPHP 框架 —— 即使应用代码异常,向导也能运行并把问题检测出来。 **Linux 大小写兼容检测**:Linux 文件系统严格区分大小写,而 Windows/macOS 不区分,本地能跑的程序上传后常因路径大小写报「Class not found」「模板不存在」「静态资源 404」。向导会在安装前自动逐级比对磁盘真实文件名,校验:关键目录与文件、PSR-4 类文件与命名空间、模板引用(`View::fetch` / `{include}` / `{extend}`)、静态资源引用(`/static/...`)、路由控制器引用。发现不一致会给出「期望 vs 实际」清单,按提示改名即可。 命令行下也可单独运行检测(CI / 部署前自查): ```bash php public/install/lib.php --check # 大小写兼容检测报告 php public/install/lib.php --check --json # JSON 输出(错误 >0 时退出码为 1) php public/install/lib.php --env # 环境检测报告 ``` ### 方式二:手动部署 #### 1. 创建数据库并导入结构 ```bash mysql -uroot -p -e "CREATE DATABASE bbs DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_general_ci;" mysql -uroot -p bbs < docs/install.sql mysql -uroot -p bbs < docs/init.sql # 可选:导入演示数据(demo/123456 等 8 个演示会员、12 篇主题) mysql -uroot -p bbs < docs/demo.sql ``` #### 2. 配置环境变量 复制 `.example.env` 为 `.env`,按需修改: ```ini APP_DEBUG = true [APP] DEFAULT_TIMEZONE = Asia/Shanghai [DATABASE] DB_TYPE = mysql DB_HOST = 127.0.0.1 DB_NAME = bbs DB_USER = root DB_PASS = DB_PORT = 3306 DB_CHARSET = utf8mb4 DB_PREFIX = bbs_ ``` #### 3. 设置目录权限 确保 `runtime/` 与 `public/storage/` 可写。 #### 4. 配置站点根目录 将 Web 服务器根目录指向 `public/`。Apache 伪静态已内置 `.htaccess`;Nginx 参考: ```nginx location / { if (!-e $request_filename) { rewrite ^(.*)$ /index.php?s=$1 last; } } ``` #### 5. 启动 ```bash # 开发环境(临时) php think run --host 0.0.0.0 --port 8000 ``` 或直接通过 Apache/Nginx 访问站点。 ## 默认账号 | 角色 | 地址 | 账号 | 密码 | |---|---|---|---| | 后台管理员 | `/admin` | `admin` | `admin888`(安装向导部署时为自定义密码) | | 前台演示会员 | `/login.html` | `demo` 等 8 个 | `123456`(带数据安装/手动导入 demo.sql 时存在) | > ⚠️ 部署后请立即通过「后台 → 系统设置 → 修改管理员密码」更改默认密码。 ## 路由速览 | 路径 | 说明 | |---|---| | `/` | 首页 | | `/forum` | 版块总览 | | `/forum/{id}/{page}.html` | 版块主题列表 | | `/thread/{id}.html` | 主题详情 | | `/latest` `/hot` `/essence` | 最新 / 热门 / 精华 | | `/search.html?keyword=` | 搜索 | | `/user/{id}` `/members` | 个人主页 / 会员列表 | | `/post/create` | 发帖 | | `/my/setting` `/my/message` | 个人设置 / 站内信 | | `/ad/click/{id}` | 广告点击计数 + 跳转 | | `/admin` | 后台看板 | | `/admin/ad` | 广告管理 | ## 富文本编辑器(TinyMCE) 所有内容编辑框均已接入 **TinyMCE 5.6.2**(参考 [layui-tinymce](https://gitee.com/chick1993/layui-tinymce) 封装),无需外网 CDN,资源全部本地化。 | 位置 | 说明 | |---|---| | 主题详情页 · 回复框 | 完整工具栏,支持图片上传 | | 主题详情页 · 楼中楼回复 | 点击「回复」时懒加载初始化(紧凑) | | 发帖页 `/post/create` | 完整工具栏,高度 460 | | 编辑主题 `/post/edit/{id}` | 完整工具栏 | | 后台 → 系统设置 · 站点公告 | 紧凑模式 | | 后台 → 版块编辑 · 版块简介 | 紧凑模式 | **关键设计:输出仍为 BBCode。** 编辑器启用 TinyMCE 官方 `bbcode` 插件,`getContent()` 直接产出 `[b]`/`[i]`/`[img]` 等 BBCode,因此数据库存储格式与前台 `parse_content()` 渲染逻辑**完全无需改动**,老数据也天然兼容。后端另加 `html_to_bbcode()` 兜底:若提交上来的仍是 HTML(插件被绕过等情况),会在入库前统一归一化为 BBCode。 **工具栏为精简版**(9 个按钮):`粗体 / 斜体 / 下划线 | 无序列表 / 有序列表 | 链接 / 图片 / 表情 | 清除格式`。已按要求移除撤销/重做箭头、段落格式下拉、删除线、引文区块(及颜色、表格、媒体等)。 **BBCode 归一化**:官方 `bbcode` 插件**不处理列表**(`