项目简介

忙狗聊（MangoChat / MGO-Liao） 是一款使用纯 PHP 编写的单文件在线聊天室，无需 MySQL、SQLite 等任何数据库，所有数据均以 JSON 文件形式存储在本地。
它采用芒果黄作为主色调，界面清新友好，支持群组聊天、私聊、用户注册登录、在线状态、管理后台等功能。
项目分为 精简版 与 增强版 两个分支，分别满足不同场景需求——如果你追求极致轻量，可以选择精简版；如果你需要更丰富的功能，增强版会是更好的选择。

---

功能特性

• 零数据库：数据全部通过 JSON 文件存储，部署即用，无需额外配置数据库。
• 一键安装：首次访问自动进入安装向导，填写聊天室名称、管理员账号即可使用。
• 多群组支持：用户可自由创建公开群组，切换聊天频道，管理员可删除群组。
• 私聊系统（增强版）：基于在线用户列表，点击即可发起一对一私密对话。
• 用户系统：支持注册与登录，密码经 password_hash 安全加密。
• 实时聊天：采用轮询与长轮询机制，消息自动刷新，延迟极低。
• 在线状态（增强版）：侧边栏实时显示当前在线人数及用户列表。
• 管理后台（增强版）：管理员可查看所有用户、删除用户、管理群组。
• 消息搜索（增强版）：输入关键词即时过滤当前聊天记录。
• CSRF 防护（增强版）：所有敏感操作均需验证 Token，安全性更高。
• 响应式布局：完美适配桌面端与移动端，移动端支持侧边栏滑出。
• 文件体积可控：单文件设计，精简版仅约 500 行，增强版约 1200 行，便于修改与二次开发。

---

精简版 vs 增强版

特性	精简版 (mangochat-little)	增强版 (主分支)
群聊	✔️	✔️
用户系统	✔️	✔️
安装向导	✔️	✔️
消息删除	普通用户仅可删自己，管理员可删所有	同精简版
私聊	❌	✔️
在线用户列表	❌	✔️
管理面板	❌	✔️
消息搜索	❌	✔️
长轮询	❌	✔️
CSRF Token	❌	✔️
代码行数	~500 行	~1200 行

选择建议：

• 如果只是想快速搭建一个简单群聊室，精简版完全够用。
• 如果需要私聊、在线状态、搜索等进阶功能，增强版更适合。

---

快速开始

环境要求

• PHP >= 7.4
• 任意 Web 服务器（Apache / Nginx）
• 项目根目录需具有写入权限（自动创建 data/ 目录）

部署

1. 下载对应版本的 index.php 文件，放置在网站根目录（或任意可访问目录）。
2. 通过浏览器访问该文件。
3. 首次打开会看到安装界面，设置聊天室名称和管理员账号密码。
4. 安装完成后即可登录使用。

所有数据（用户、群组、消息记录）均保存在 data/ 文件夹下的 JSON 文件中，方便备份与迁移。

---

界面预览

• 安装页面：芒果黄色调，简洁表单填写聊天室信息。
• 登录 / 注册：居中卡片设计，支持切换登录与注册。
• 聊天主界面：左侧边栏展示群组与在线用户（增强版），右侧为消息列表与输入区，顶部可搜索消息。
• 管理面板（增强版）：弹窗展示用户管理与群组管理表格。

---

技术亮点

• 纯 PHP + JSON：脱离数据库依赖，大幅降低部署门槛，适合个人学习或小型团队。
• 长轮询实现低延迟（增强版）：服务器端保持连接，有新消息立即返回，减少无效轮询。
• 安全的密码存储：使用 password_hash 和 password_verify，不保存明文密码。
• CSRF 防护（增强版）：通过 Session Token 验证所有 POST 请求，防止跨站请求伪造。
• 移动端适配：Flex 布局 + 媒体查询，移动端滑出侧边栏，操作流畅。
• 模块化设计：所有逻辑集中在一个文件中，但仍保持了清晰的 API 路由与函数划分，便于理解和修改。

---

开源地址

忙狗聊已在 GitCode 开源，欢迎 Star、Fork 和 Issue！

• 增强版（主分支）：https://gitcode.com/Mango_Club/mangochat
• 精简版（mangochat-little 分支）：https://gitcode.com/Mango_Club/mangochat/tree/mangochat-little

---

关于团队

• 开发团队：Mango 团队
• 主要开发者：叫我弓木吉
• 技术栈：PHP + JSON + HTML/CSS/JS
• 项目口号：用爱发电，轻量即自由

---

结语

忙狗聊从一个简单的单文件聊天室起步，不断迭代优化，既保留了极简的安装体验，又逐步加入了私聊、管理后台等实用功能。
无论是想学习 PHP 单文件应用的写法，还是需要一个小型内部沟通工具，都可以试试忙狗聊。
如果你有任何建议或问题，欢迎在 GitCode 仓库中提出，一起让这个小工具变得更好！

---

作者推荐

Mango团队的另一个开源项目强烈推荐：
MGO空间管理面板
此项目可以帮助你更好的管理服务器、虚拟主机等Web服务器，本项目完全适配MGO空间管理面板V1.3-Open，欢迎部署！