📌 项目简介

一个轻量级的多平台热榜聚合展示系统。前端以板块形式聚合展示各大平台热搜，后台支持手动管理，配合宝塔计划任务可实现全自动数据更新。

✨ 核心功能

• 多源聚合：支持微博、百度、哔哩哔哩、今日头条、抖音、GitHub、IT之家等主流平台。
• 响应式布局：首页一行三列展示，每个板块右上角提供「更多 ›」跳转至原平台完整榜单。
• 实时搜索：前端支持关键词过滤，快速定位感兴趣的内容。
• 后台管理：支持账号密码登录，可手动刷新热榜、启用/停用特定平台。
• 自动更新：通过宝塔「计划任务 – 访问URL」自动拉取最新数据。
• 零依赖数据库：采用 SQLite 单文件存储，无需安装 MySQL/MariaDB。

---

⚙️ 环境要求

组件	要求	备注
PHP	≥ 7.1	必须开启 curl、pdo_sqlite、sqlite3 扩展
Web服务器	Nginx / Apache	需支持外网访问（用于抓取数据）
面板	宝塔面板（推荐）	用于配置定时任务，非强制但强烈推荐

---

🚀 部署步骤

1. 上传文件
   将项目所有文件上传至网站根目录（例如：/www/wwwroot/rebang）。
2. 检查扩展
   在 PHP 管理中确认已安装并启用以下扩展：
   • curl
   • pdo_sqlite
   • sqlite3
3. 访问前端
   浏览器打开：http://你的域名/index.php
4. 进入后台
   浏览器打开：http://你的域名/admin/login.php

---

🔐 配置修改（⚠️ 务必执行）

编辑 includes/config.php 文件，修改默认安全凭证：

define('ADMIN_USER', 'admin');      // 后台用户名
define('ADMIN_PASS', 'admin123');   // 后台密码（请立即修改！）
define('CRON_TOKEN', 'rebang2026'); // 计划任务验证令牌（请修改为复杂字符串）

⚠️ 安全警告：默认密码和 Token 存在安全风险，部署后请第一时间修改。

---

⏰ 配置自动更新（宝塔计划任务）

为确保热榜数据实时性，建议配置每 5 分钟自动抓取一次：

1. 登录 宝塔面板 → 点击 「计划任务」。
2. 添加新任务，参数如下：
   • 任务类型：访问URL
   • 任务名称：热榜更新
   • 执行周期：每 5 分钟
   • URL地址：https://你的域名/cron.php?token=你设置的CRON_TOKEN
3. 保存后点击 「执行」 进行测试。
4. 成功标志：返回内容包含 {"ok":true,...} 即表示配置正确。

💡 提示：后台也有「立即更新热榜」按钮，可在登录后手动触发（需有效会话）。

---

🗄️ 数据库说明

• 存储位置：data/rebang.db（首次访问时自动创建）
• 安全防护：data/ 目录已通过 .htaccess 禁止 Web 直接访问
• 表结构：
  • platforms：平台基础信息
  • hot_items：热榜条目数据

---

➕ 新增平台指南

如需接入新的热榜源，请按以下步骤操作：

1. 编写抓取函数
   在 includes/fetcher.php 中新增 fetch_xxx() 函数。返回值格式：[['rank' => 1, 'title' => '标题', 'url' => '链接', 'hot' => '热度值'], ...]
2. 注册平台信息
   在 includes/db.php 的 $defaults 数组中添加对应平台的 pkey、名称、图标及排序权重。
3. 后台启用
   登录后台 → 「平台管理」→ 找到新平台并点击启用。

---

📂 目录结构

rebang/
├── index.php          # 前端展示页
├── cron.php           # 计划任务更新入口
├── api.php            # 通用接口（update/data）
├── admin/             # 后台管理模块（login/logout/index）
├── includes/          # 核心逻辑（配置、数据库、抓取、认证）
├── assets/            # 静态资源（CSS/JS/图片）
└── data/              # SQLite 数据库存放目录（自动生成）

---

⚠️ 免责声明

• 所有热榜数据均来自各平台公开 API 或页面，仅供学习与交流使用。
• 部分平台接口可能随官方版本更新而失效，若后台出现失败提示，请及时更新 includes/fetcher.php 中对应的抓取逻辑。