Skip to content

Latest commit

 

History

History
314 lines (229 loc) · 12.3 KB

README.md

File metadata and controls

314 lines (229 loc) · 12.3 KB
Raw

php-epg

PHP-EPG-Docker-Server 📺

Docker Pulls Image Size

PHP 实现的 EPG（电子节目指南）服务端， Docker 部署，自带设置界面，支持 DIYP & 百川 、 超级直播 以及 xmltv 格式。

主要功能 ℹ️

  • 支持返回 DIYP & 百川 、 超级直播 以及 xmltv 格式 📡
  • 一键生成匹配 M3U 的 xmltv 格式 EPG 文件 💯
  • 支持查看频道匹配结果 🪢
  • 提供 amd64 跟 arm64 架构 Docker 镜像，支持电视盒子等设备 🐳
  • 基镜像采用 alpine-apache-php，压缩后大小仅 20M 📦
  • 采用先构建再存数据库的策略，提高读取速度 🚀
  • 支持繁体中文频道匹配 🌐
  • 支持双向模糊匹配 ✍🏻
  • 支持多对一频道映射，支持正则表达式 🔄
  • 支持设置频道忽略字符表 🔇
  • 支持生成指定频道节目单 📝
  • 内置定时任务，支持设置定时拉取数据 ⏳
  • 兼容多种 xmltv 格式 🗂️
  • 使用 SQLite 数据库存储 🗃️
  • 包含网页设置页面 🌐
  • 支持多个 EPG 源 📡
  • 可配置数据保存天数 📅
  • 内置 phpLiteAdmin 方便管理数据库 🛠️

设置页面

内置正则表达式说明：

  • 以 regex: 作为前缀
  • 示例：
    • regex:/^CCTV[-\s]*(\d+(\s*P(LUS)?|[K\+])?)(?![\s-]*(美洲|欧洲)).*/i => CCTV$1 ：将 CCTV 1综合、CCTV-4K频道、CCTV - 5+频道、CCTV - 5PLUS频道 等替换成 CCTV1、CCTV4K、CCTV5+、CCTV5PLUS（排除 CCTV4美洲 和 CCTV4欧洲）

更新日志 📝

2024-9-4：

  1. 修复：生成 xmltv 时，频道匹配错误
  2. 修复：频道映射为空时，显示 =>

2024-9-3：

  • 新增：数据导入导出（包括 config.json 跟 data.db 文件）

2024-9-1：

  1. 新增：反向模糊匹配（如 湖南茶频道 能匹配 茶频道）

    可能出现错误匹配：如数据库中只有 CGTN 跟 CGTN西语 ，请求 CGTN西班牙语 会返回 CGTN ，需自行添加频道映射

  2. 优化：频道匹配顺序

    优先精准匹配，其次正向模糊匹配（超级体育 => NewTV超级体育），最后反向模糊匹配（湖南茶频道 => 茶频道）

  3. 优化：去掉绝大部分 频道忽略字符串 跟 频道映射
  4. 优化：跨天数据处理逻辑

其他见历史更新日志

TODO：

  • 支持返回超级直播格式
  • 整合更轻量的 alpine-apache-php 容器
  • 整合生成 xml 文件
  • 支持多对一频道映射
  • 支持繁体频道匹配
  • 仅保存指定频道列表节目单
  • 导入/导出配置
  • 频道指定 EPG 源

部署步骤 🚀

  1. 配置 Docker 环境

  2. 若已安装过，先删除旧版本（注意备份数据）

    docker rm php-epg -f

  3. 拉取镜像并运行：

    docker run -d \
  --name php-epg \
  -p 5678:80 \
  --restart always \
  taksss/php-epg:latest

    默认端口为 5678 ，根据需要自行修改。 无法正常拉取镜像的，可使用同步更新的 腾讯云容器镜像（ccr.ccs.tencentyun.com/taksss/php-epg:latest）

数据持久化

  • 直接使用以下命令，./data 可根据自己需要更改

    docker run -d \
  --name php-epg \
  -v ./data:/htdocs/epg/data \
  -p 5678:80 \
  --restart always \
  taksss/php-epg:latest

  • 新建 docker-compose.yml 文件后，在同目录执行 docker-compose up -d

使用步骤 🛠️

  1. 在浏览器中打开 http://{服务器IP地址}:5678/epg/manage.php

  2. 默认密码为空，根据需要自行设置

  3. 添加 EPG 源地址， GitHub 源确保能够访问，点击 更新配置 保存

  4. 点击 更新数据库 拉取数据，点击 数据库更新日志 查看日志，点击 查看数据库 查看具体条目

  5. 设置 定时任务 ，点击 更新配置 保存，点击 定时任务日志 查看定时任务时间表

    建议从 凌晨1点 左右开始抓，很多源 00:00 ~ 00:30 都是无数据。 隔 6 ~ 12 小时抓一次即可。

  6. 点击 更多设置 ，选择是否 生成xml文件 、生成方式 ，设置 限定频道节目单

  7. 用浏览器测试各个接口的返回结果是否正确：

    • xmltv 接口： http://{服务器IP地址}:5678/epg/index.php
    • DIYP&百川 接口： http://{服务器IP地址}:5678/epg/index.php?ch=CCTV1
    • 超级直播 接口： http://{服务器IP地址}:5678/epg/index.php?channel=CCTV1

  8. 将 http://{服务器IP地址}:5678/epg/index.php 填入 DIYP、TiviMate 等软件的 EPG 地址栏

    • ⚠️ 直接使用 docker run 运行的话，可以将 :5678/epg/index.php 替换为 :5678/epg。
    • ⚠️ 部分软件不支持跳转解析 xmltv 文件，可直接使用 :5678/epg/t.xml.gz 或 :5678/epg/t.xml 访问。

快捷键：

  • Ctrl + S：保存设置
  • Ctrl + /：对选中 EPG 地址设置（取消）注释

设置定时任务

设置定时任务

定时任务日志

定时任务日志

更新日志

更新日志

搜索频道、编辑映射

编辑频道映射

更多设置

更多设置

查看频道匹配 查看频道匹配

phpLiteAdmin

phpLiteAdmin

效果示例 🖼️

DIYP

DIYP 示例

TiviMate

TiviMate

历史更新记录

2024-8-30：

  1. 新增：从频道列表新建映射关系（频道映射 -> 点击编辑）
  2. 优化：定时任务 pid 获取方式
  3. 优化：解析后预加载频道匹配结果

2024-8-29：

  1. 新增：查看频道匹配结果（更多设置 -> 解析 -> 查看匹配）
  2. 优化：非 Docker 用户体验
  3. 优化：频道忽略字符串替换顺序

2024-8-26：

  1. 优化：数据重复时的更新逻辑（越前面，优先级越高）
  2. 优化：频道映射规则（针对 51zmt 的 CCTV4EUO 跟 CCTV4AME 命名）
  3. 优化：频道映射界面改回之前的版本（新版本直观，但在修改规则时效率太低）

2024-8-24：

  1. 新增：改用 XMLWriter 生成 xmltv 文件，加快生成速度，降低内存占用（生成全量数据，100M 以内即可）
  2. 新增：“限定频道列表”可直接从 M3U 、 TXT 地址获取
  3. 新增：设置“限定频道列表”后，生成 xmltv 的频道名以列表的为准（可生成匹配 M3U 的 EPG 文件）
  4. 新增：NewTV、SiTV、iHOT、CHC 系列频道映射规则
  5. 优化：将数据文件统一放到 data 文件夹，方便进行数据持久化（⚠️注意更新）
  6. 优化：节目匹配时，优先采用精确匹配结果
  7. 优化：部分 EPG 条目跨天时，生成 2 条数据
  8. 优化：desc 字段的生成逻辑
  9. 优化：删除部分冗余选项

⚠️该版本改动较多，建议直接更新

2024-8-21：

  1. 新增：退出按钮（感谢mxdabc）
  2. 修复：语法错误（感谢mxdabc）
  3. 新增：使用 GitHub Actions 生成、推送镜像到 DockerHub 及 腾讯云容器镜像站
  4. 修复：点击退出按钮后再次登录，无法查看日志

2024-8-20：

  1. 新增：同步提供 腾讯云容器镜像 ，无法正常拉取镜像的用户可使用
  2. 新增：默认返回“精彩节目”选项
  3. 新增：更新前检查 EPG 文件，无变化则跳过
  4. 优化：分批插入数据，降低内存占用
  5. 优化：配置文件从 config.php 改为 config.json
  6. 修复：频道映射每次只能更新一条的问题

2024-8-14：

  1. 优化：频道映射显示方式
  2. 新增：同时生成 .xml.gz 及 .xml 选项

2024-8-12：

  1. 新增：xmltv 文件格式选项（ .xml.gz 或 .xml）
  2. 优化：频道映射忽略空格（如 CGTN英语 => CGTN 可对 CGTN 英语 进行映射）
  3. 优化：正则表达式，增加 CCTV 5P 频道匹配

2024-8-5：

  1. 修改部分 opencc 及 update.php 代码，兼容 PHP 7.0 以上版本
  2. 新增 入库前处理频道名 选项（ DIYP 跟 超级直播 用户保持默认 是 即可）
  3. 更新 manage.php ，打开设置页面时检查定时任务运行情况
  4. 优化正则表达式，增加 CCTV 5PLUS 频道匹配
  5. 新增 docker-compose.yml ，可持久化 adata.db 跟 config.json 文件

2024-7-31：

  1. 部分用户反馈 phpLiteAdmin-ng 在 php7.x 上打开较慢，已换回之前的 phpLiteAdmin 1.9.71
  2. 修复 phpLiteAdmin 1.9.71 部分节目不显示的问题：
    • 将部分 substr 、 strlen 替换为 mb_substr 、 mb_strlen
  3. 修复未进入“更多设置”页面，Ctrl+S 会清空限定频道列表的问题

2024-7-30：

  1. 支持繁体中文频道匹配（感谢 overtrue/php-opencc ）
  2. 支持生成指定频道节目单（可通过 .txt 或 .m3u 节目源导入）
  3. 调整页面布局，将部分设置放至“更多设置”页面中
  4. 生成 .xml.gz 时，默认只包含预告数据（可在设置中更改）
  5. 修改频道忽略字符串逻辑，将忽略空格设为可选（默认开启）
  6. EPG 地址列表支持 Ctrl + / 设置（取消）注释
  7. 重构部分代码，加快数据生成速度，降低内存占用
  8. 改用 phpLiteAdmin-ng ，修复节目显示不完全的问题
  9. 修复频道包含 & 字符，报 Warning 的问题
  10. 修复 cron.php 首次执行在特定情况下异常的问题

功能基本完善，没大改动的话会比较少更新了。

2024-7-26：

  1. 自定义频道名支持多对一映射
  2. 支持整合 xmltv，并生成 .xml.gz 文件，降低硬盘占用
  3. 支持查看、搜索数据库频道列表，方便填写映射
  4. 修复 cron.php 在第三天失效的问题
  5. 删除 epg_lovetv 表，超级直播数据直接从对应 DIYP 中生成，减少数据冗余
  6. 优化更新当天数据的逻辑，避免更新时无法获取节目表

2024-7-21：

  1. 支持 超级直播 格式
  2. 重构代码，基镜像改为 alpine-apache-php ，镜像大小从 155M 下降到 23M
  3. 支持解析 M3U4U 等非 .xml/.gz 结尾 EPG 地址
  4. 数据分批插入，降低内存占用
  5. 修复部分界面显示异常问题
  6. 修复设置页面刷新，提示“是否重新提交表单”问题
  7. 增加接口测试说明

2024-7-18：

  1. 提供 Docker🐳 镜像（基于 php:7.4-apache ，支持 x86-64 跟 arm64 ）
  2. 支持定时更新数据库
  3. EPG 源支持添加注释
  4. 支持更改登录密码 【默认为空！！！】
  5. 支持查看定时任务日志
  6. 支持查看数据库更新日志
  7. 配置页面支持 Ctrl+S 保存
  8. 更新部署流程

2024-7-14：

  1. 改用 Docker Compose🐳 部署
  2. 更新部署流程

2024-7-13：

  1. 优化自带正则表达式
  2. 更新默认返回数据，供回放使用
  3. 增加 TiviMate 示例图片

2024-7-13初始版本：

  1. 支持标准 xmltv 和 DIYP&百川 格式
  2. 包含网页设置页面
  3. 支持多个 EPG 源
  4. 可配置数据保存天数
  5. 支持设置频道忽略字符串
  6. 支持频道映射，支持正则表达式
  7. 内置 phpLiteAdmin 方便管理数据库

特别鸣谢 🙏