# HuBBS免费开源论坛程序

**Repository Path**: youruihu/hubbs

## Basic Information

- **Project Name**: HuBBS免费开源论坛程序
- **Description**: 一款免费开源论坛程序。
- **Primary Language**: PHP
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: https://bbs.huyourui.com
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2026-03-27
- **Last Updated**: 2026-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HuBBS v1.7.9 发布说明

## 产品简介

HuBBS 是一款轻量级、高性能的开源论坛程序，采用 PHP + MySQL 架构，支持亿级数据量。设计简洁优雅，功能完善，适合各类社区建设。

## 主要特性

### 核心功能
- ✅ 用户系统（注册、登录、个人中心）
- ✅ 帖子发布、编辑、删除
- ✅ 回复功能（支持楼中楼回复）
- ✅ 板块分类管理（支持二级分类）
- ✅ 置顶、精华、锁定帖子
- ✅ 点赞、收藏功能
- ✅ 消息通知系统
- ✅ 友情链接管理

### 编辑器功能
- ✅ 所见即所得（WYSIWYG）富文本编辑器
- ✅ 图片上传（支持多图、拖拽上传）
- ✅ 附件上传
- ✅ 文字排版（字号、颜色、背景色）
- ✅ 对齐方式（左对齐、居中、右对齐、两端对齐）
- ✅ 引用、代码、链接、分隔线
- ✅ 撤销/重做
- ✅ 快捷键支持（Ctrl+Enter 提交）

### 管理功能
- ✅ 后台管理面板
- ✅ 用户管理（封禁、注销、恢复）
- ✅ 帖子管理（审核、删除、移动）
- ✅ 板块管理
- ✅ 友情链接管理
- ✅ 系统设置（35+ 配置项）
- ✅ 上传设置（图片/附件大小、类型限制）

### 安全特性
- ✅ CSRF 防护
- ✅ SQL 注入防护
- ✅ XSS 过滤
- ✅ 密码加密存储
- ✅ 用户软删除（保留内容，可恢复）
- ✅ 邮箱验证（可选开启）

### 其他特性
- ✅ 响应式设计（支持移动端）
- ✅ 字符头像（自动生成）
- ✅ 记住登录
- ✅ 未读消息提醒
- ✅ SEO 优化

## 系统要求

- PHP 7.4 或更高版本
- MySQL 5.7+ 或 MariaDB 10.2+
- PDO 扩展
- PDO_MySQL 扩展
- GD 扩展（图片处理）

## 安装步骤

### 1. 下载并解压
将程序文件解压到网站根目录或子目录。

### 2. 创建数据库
在 MySQL 中创建一个新的数据库（如 `hubbs`）。

### 3. 运行安装程序
访问 `http://your-domain.com/install/`，按提示完成安装：
- 填写数据库连接信息
- 设置管理员账号
- 完成安装

### 4. 删除安装目录（可选）
安装完成后，建议删除 `install/` 目录或保留 `install.lock` 文件。

## 默认配置

### 默认板块
- 默认板块（强制选择分类已开启）

### 默认友情链接
- HuBBS官网：https://bbs.huyourui.com

### 默认设置
- 开放注册：是
- 邮箱验证：否（可在后台开启）
- 强制选择板块：是
- 每页帖子数：20
- 每页回复数：20

## 目录结构

```
hubbs/
├── core/               # 核心类库
│   ├── Auth.php       # 认证类
│   ├── DB.php         # 数据库类
│   ├── Settings.php   # 设置类
│   ├── Migrate.php    # 迁移类
│   ├── Upload.php     # 上传类
│   ├── Model.php      # ORM模型基类
│   ├── Router.php     # 路由系统
│   ├── View.php       # 模板引擎
│   └── functions.php  # 公共函数
├── models/            # 数据模型
│   ├── User.php       # 用户模型
│   ├── Post.php       # 帖子模型
│   ├── Forum.php      # 板块模型
│   └── ...
├── services/          # 业务服务层
│   ├── PostService.php       # 帖子服务
│   ├── NotificationService.php # 通知服务
│   └── ...
├── api/               # RESTful API
│   ├── ApiResponse.php
│   ├── ApiAuth.php
│   ├── PostApi.php
│   ├── UserApi.php
│   └── ...
├── modules/           # 功能模块
│   ├── admin.php      # 后台管理
│   ├── post.php       # 帖子模块
│   ├── user.php       # 用户模块
│   └── ...
├── templates/         # 模板文件
│   └── default/       # 默认主题
├── static/            # 静态资源
│   ├── css/
│   ├── js/
│   └── img/
├── uploads/           # 上传目录（需可写）
├── data/              # 数据目录（需可写）
├── tests/             # 单元测试
│   ├── TestCase.php   # 测试基类
│   ├── TestRunner.php # 测试运行器
│   └── UtilsTest.php  # 工具函数测试
├── install/           # 安装程序
└── index.php          # 入口文件
```

## 升级说明

### 从旧版本升级
1. 备份数据库和配置文件
2. 上传新版本文件（保留 `data/config.php`）
3. 访问网站，迁移系统会自动执行数据库更新
4. 清除缓存

## 常见问题

### Q: 安装后无法显示后台入口？
A: 请检查管理员用户是否正确创建，确保 `is_admin = 1`。

### Q: 如何开启邮箱验证？
A: 在后台"网站设置"中配置 SMTP 信息，然后开启"注册需要验证邮箱"。

### Q: 如何修改上传文件大小限制？
A: 在后台"上传设置"中修改，同时需要调整 PHP 的 `upload_max_filesize` 和 `post_max_size`。

### Q: 支持子目录安装吗？
A: 支持，但建议使用根目录安装以获得最佳体验。

## 安全建议

1. 安装完成后删除 `install/` 目录
2. 定期修改管理员密码
3. 开启 HTTPS
4. 定期备份数据库
5. 保持程序更新

## 开源协议

本项目采用 **GNU General Public License v3.0 (GPLv3)** 协议开源。

### 协议要点

- **自由使用**：您可以自由运行、复制、分发本程序
- **开放源码**：修改后的版本必须开源，并使用相同协议
- **专利授权**：贡献者授予用户专利使用权
- **禁止闭源**：基于本程序的衍生作品必须保持开源

### 用户权利与义务

#### 您有权
- 自由使用本程序于任何目的
- 学习、研究程序的工作原理
- 修改程序以满足您的需求
- 重新分发副本帮助他人

#### 您必须
- 基于本程序的修改版本必须使用 GPLv3 协议开源
- 分发时提供完整的源代码
- 保留版权声明和免责声明
- 标注您所做的修改

### 完整协议文本

完整的 GPLv3 协议文本请参见：[https://www.gnu.org/licenses/gpl-3.0.html](https://www.gnu.org/licenses/gpl-3.0.html)

### 商业使用

GPLv3 允许商业使用，但请确保遵守上述开源义务。如果您需要在闭源项目中使用，请联系我们获取商业授权。

## 技术支持

- 官方网站：https://bbs.huyourui.com
- Gitee：https://gitee.com/yourname/hubbs
- GitHub：https://github.com/yourname/hubbs
- 问题反馈：请在 Gitee Issues 提交

## 更新日志

### v1.7.8 (2026-04-19)
- **Bug 修复：进一步优化 base_url() 函数**
  - 优先使用 SCRIPT_NAME/PHP_SELF 计算路径
  - 添加备选方案使用 DOCUMENT_ROOT
  - 创建 debug_url.php 调试页面帮助诊断问题

### v1.7.7 (2026-04-19)
- **Bug 修复：base_url() 路径计算**
  - 修复服务器环境下 Logo 和首页链接 URL 错误的问题
  - 改用 HUBBS_ROOT 和 DOCUMENT_ROOT 计算基础路径
  - 避免依赖 $_SERVER['SCRIPT_NAME'] 导致的兼容性问题
  - 支持各种服务器配置（Nginx、Apache 重写等）

### v1.7.6 (2026-04-19)
- **UI 优化：后台导航优化**
  - 将顶部导航"更新"改为"关于"，避免与页面标题"系统更新"重复
  - 保持红点提示功能，有新版本时仍会显示

### v1.7.5 (2026-04-19)
- **UI 优化：友情链接表单美化**
  - 重新设计表单卡片布局，添加渐变背景和阴影效果
  - 添加表单头部图标和标题区域
  - 优化输入框样式，添加悬停和聚焦效果
  - 链接地址输入框添加 https:// 前缀提示
  - 描述和排序字段采用双列布局
  - 按钮样式优化，添加渐变和悬停动画
  - 添加响应式设计，适配移动端
  - 修复按钮错位问题

### v1.7.4 (2026-04-19)
- **Bug 修复：路径兼容性**
  - 修复顶部导航 Logo 链接硬编码为根目录的问题
  - 修复顶部导航首页链接硬编码为根目录的问题
  - 修复后台管理模板 CSS 链接使用相对路径的问题
  - 修复后台管理所有导航链接使用相对路径的问题
  - 所有链接统一使用 `base_url()` 函数，支持子目录部署

### v1.7.3 (2026-04-19)
- **架构优化：Service 层分离**
  - 新增 PostService 服务层，分离业务逻辑与数据访问
  - 新增 NotificationService 服务层，统一通知管理
  - 提升代码可维护性和可测试性
- **模板引擎增强**
  - 重构 View 类，支持模板继承、组件化
  - 新增模板缓存机制
  - 添加条件渲染和循环渲染辅助方法
  - 提供 view() 和 display() 全局辅助函数
- **单元测试框架完善**
  - 新增 TestCase 基类，提供丰富的断言方法
  - 新增 TestRunner 测试运行器，支持彩色 CLI 输出
  - 新增 UtilsTest 测试用例，覆盖核心工具函数
  - 支持 HTML 测试报告生成
- **代码质量提升**
  - 完善代码注释，提升可读性
  - 优化代码结构，符合 PSR 规范
  - 增强跨平台兼容性（Linux/Windows）

### v1.7.2 (2025-04-03)
- **后台管理优化**
  - 修复友情链接管理页面头部导航样式问题
  - 优化友情链接编辑：保存成功后显示提示并返回列表

### v1.7.1 (2025-04-03)
- **更新系统优化**
  - 修复 Gitee API 403 错误：使用浏览器 User-Agent 和完整请求头
  - 添加备用 HTTP 请求方案（cURL + file_get_contents）
  - 优化后台更新页面：无法检测版本时也显示手动上传功能
  - 添加详细错误信息显示
- **更新排除列表完善**
  - 添加更多服务器环境文件排除（.htaccess、.well-known 等）
  - 添加 IDE 配置、测试文件等排除项

### v1.7.0 (2025-04-03)
- **安装程序优化**
  - 增强环境检测：PHP版本、扩展、目录权限全面检查
  - 修复路径兼容性：支持根目录和子目录部署
  - 添加详细错误提示和权限检查
- **更新程序优化**
  - 完善排除列表：避免覆盖用户数据和配置文件
  - 支持更多服务器环境文件排除
- **代码优化**
  - 清理仓库：移除非必要文件
  - 完善.gitignore配置
  - 修复头像上传相关问题

### v1.6.0 (2025-04-02)
- **新增功能：ORM 系统**
  - 新增 Model 基类，支持 Active Record 风格操作
  - 新增 User、Post、Forum 等数据模型
  - 支持查询构建器、关联关系、软删除
- **新增功能：RESTful API**
  - 新增完整的 API 接口（帖子、用户、板块、通知）
  - 支持 API 认证和权限控制
  - 统一的 API 响应格式
- **新增功能：路由系统**
  - 新增 Router 类，支持 RESTful 风格路由
  - 支持路由参数绑定和中间件
  - 兼容传统 URL 参数路由
- **新增功能：单元测试框架**
  - 新增 TestCase 测试基类
  - 新增 TestRunner 测试运行器
  - 新增系统测试页面（test.php）
- **优化**：顶部导航链接统一使用 base_url()
- **优化**：静态资源添加版本号防止缓存
- **修复**：路由系统支持子目录部署

### v1.5.1 (2025-04-02)
- 修复：更新检查错误处理和错误信息显示
- 修复：后台更新页面模板引用错误

### v1.5.0 (2025-04-01)
- 新增功能：自动更新系统（基于 Gitee Release）
- 新增功能：后台一键更新，自动备份和回滚
- 新增功能：版本检测和更新提醒
- 优化：账号设置页面默认头像显示

### v1.3.0 (2025-03-31)
- 新增功能：板块指定用户发帖权限
- 新增功能：发帖页面隐藏无权限板块
- 修复：编辑帖子页面板块权限过滤
- 修复：is_banned 未定义错误

### v1.2.0 (2025-03-31)
- 新增功能：帖子和评论编辑功能
- 新增功能：显示编辑次数和最后编辑时间
- 新增功能：删除帖子时自动删除关联的图片和附件
- 隐私保护：个人中心邮箱仅自己可见
- 代码优化：版本号统一管理

### v1.1.0 (2025-03-31)
- 安全增强：修复 SQL 注入风险
- 安全增强：数据库密码加密存储
- 稳定性增强：添加数据库事务控制
- 代码优化：完善错误处理机制

### v1.0.0 (2025-03-31)
- 初始版本发布
- 完整的论坛功能
- 富文本编辑器
- 后台管理系统
- 响应式设计

---

**感谢使用 HuBBS！**