# forum

**Repository Path**: xiuyegege/forum

## Basic Information

- **Project Name**: forum
- **Description**: 简单的留言论坛,用于学习flask完整搭建项目
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-04
- **Last Updated**: 2026-02-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# forum

#### 介绍
一个基于Flask框架开发的简单留言论坛系统，用于学习Flask完整项目搭建。该项目实现了用户注册、登录、留言发布等基本功能，适合Flask初学者学习参考。

#### 功能特性

- ✅ 用户注册与登录
- ✅ 密码安全加密存储
- ✅ 留言发布与查看
- ✅ 响应式前端界面
- ✅ MySQL数据库集成
- ✅ 会话管理

#### 技术栈

- **后端框架**: Flask 3.1.2
- **数据库**: MySQL + PyMySQL
- **前端**: HTML5 + CSS3 + JavaScript
- **密码安全**: Werkzeug密码哈希
- **模板引擎**: Jinja2

#### 项目结构

```
forum/
├── handle_DB/           # 数据库管理模块
│   └── handl_db.py     # 数据库连接和操作类
├── static/             # 静态资源文件
│   ├── style.css      # 样式文件
│   └── script.js      # 前端脚本
├── templates/          # 模板文件
│   ├── home_page.html # 首页/留言板
│   ├── login.html     # 登录页面
│   ├── register.html  # 注册页面
│   └── message.html   # 留言页面
├── route.py           # 路由和业务逻辑
├── handle_db.py       # 主数据库操作文件
├── requitements.txt   # 项目依赖
└── README.md          # 项目说明
```

#### 安装教程

1. **克隆项目**
   ```bash
   git clone https://gitee.com/xiuyegege/forum.git
   cd forum
   ```

2. **安装依赖**
   ```bash
   pip install -r requitements.txt
   ```

3. **数据库配置**
   - 创建MySQL数据库 `forum`
   - 修改 `handle_DB/handl_db.py` 中的数据库连接信息
   - 创建用户表（项目会自动处理）

4. **运行应用**
   ```bash
   python route.py
   ```

5. **访问应用**
   打开浏览器访问 `http://localhost:5000`

#### 使用说明

1. **注册账号**
   - 访问注册页面填写用户名和密码
   - 密码会自动进行安全加密存储

2. **登录系统**
   - 使用注册的账号密码登录
   - 登录后可以查看和发布留言

3. **发布留言**
   - 在留言板页面输入留言内容
   - 提交后留言会显示在留言列表中

#### 数据库设计

- **users表**: 存储用户信息（用户名、加密密码）
- **messages表**: 存储留言内容（留言内容、用户ID、时间戳）

#### 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

#### 学习要点

- Flask路由和视图函数的使用
- Jinja2模板渲染
- MySQL数据库操作
- 用户认证和会话管理
- 密码安全加密
- 前后端数据交互

#### 许可证

本项目仅用于学习目的，遵循MIT许可证。