
一套轻量级、无数据库、纯文件驱动的视频聚合展示系统,支持多播放源切换、瀑布流响应式布局、分类筛选与全文搜索,适合快速搭建个人视频收藏夹或内容聚合站,本系统专为极简部署与灵活管理设计,摒弃传统 MySQL/PDO 依赖,以 CSV 文件作为数据核心,实现视频内容的增删改查与前端展示。无论是个人珍藏、团队共享,还是作为小型内容站,都能在 5 分钟内完成部署并投入使用。
核心设计哲学:
零数据库维护:编辑
videos.csv即完成数据操作,支持 Excel/WPS 直接编辑。多源聚合:每条视频可预设多个播放地址(如不同 CDN、备用线路),前端一键切换,自动过滤失效链接。
响应式瀑布流:从手机到 4K 显示器,列数智能适配,浏览体验流畅自然。
中文编码无忧:自动识别 UTF-8、GBK、GB2312,乱码问题不复存在。
🚀 核心亮点
1. CSV 驱动,数据即文档
无需安装数据库,只需维护一个
videos.csv文件。支持字段:
标题,分类,封面图URL,播放源1,播放源2,播放源3,描述,标签(可自定义扩展)。支持 Excel 打开另存为 CSV,或直接用文本编辑器按逗号分隔编辑。
2. 多播放源智能切换
每条视频可配置最多 5 个备用源(如
https://cdn1/xxx.mp4、https://cdn2/xxx.mp4)。前端播放器内置源选择器,用户可手动切换;系统同时自动检测源可用性,优先展示可播链接。
无效链接(404/超时)会被自动过滤,不影响观看体验。
3. 瀑布流响应式布局
基于 CSS Grid 与 Flexbox,无需第三方 UI 库。
断点适配:
手机(< 640px):2 列
平板(640~1024px):3 列
桌面(1024~1440px):4 列
大屏(> 1440px):5 列
卡片高度随内容自适应,图片懒加载,滚动性能优化。
4. 分类 + 搜索 + 排序
分类筛选:前端自动提取所有分类生成标签栏,点击即过滤。
关键词搜索:实时检索标题、描述、标签字段,不区分大小写。
多方式排序:支持按发布时间、按热度(播放量/点赞数)、按标题字母顺序,满足不同浏览习惯。
5. 编码自动识别
后端使用
mb_detect_encoding+iconv自动转换 CSV 文件编码。无论你上传的是 GBK 导出的老数据,还是 UTF-8 的新内容,系统均能正确解析,中文不会出现问号或乱码。
6. 文件缓存机制
首次读取 CSV 后生成序列化缓存文件(存放于
data/目录),后续请求直接读取缓存,大幅降低磁盘 I/O。支持缓存过期时间设置(默认 3600 秒),也可在
up.php更新数据时手动清空缓存。


