PHP-EPG-Docker-Server 📺

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

主要功能 ℹ️

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

内置正则表达式说明：

以 regex: 作为前缀

示例：

regex:/^CCTV[-\s]*(\p{Han})/iu, $1 ：将 CCTV风云足球、cctv-风云音乐 等替换成 风云足球、风云音乐

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

regex:/^(深圳.*?)频道$/i, $1 ：将 深圳xx频道 替换成 深圳xx

更新日志 📝

2024-8-5更新：

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

亦可使用以下命令，需确保 当前目录 包含上述文件

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

2024-7-31更新：

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

2024-7-30更新：

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

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

2024-7-26更新：

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

2024-7-21更新：

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

2024-7-18更新：

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

2024-7-14更新：

改用 Docker Compose🐳 部署
更新部署流程

2024-7-13更新：

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

2024-7-13初始版本：

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

TODO：

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

部署步骤 🚀

配置 Docker 环境
若已安装过，先删除旧版本（注意备份数据）
```
docker rm php-epg -f
```

拉取镜像并运行：

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

默认端口为 5678 ，根据需要自行修改。

adata.db 跟 config.php 文件持久化：
- 下载 源代码 后，在 根目录 执行 docker-compose up -d 部署（后续升级无需重新下载源代码）
- 或执行以下命令，需确保 当前目录 存在文件
```
docker run -d \
  --name php-epg \
  -v ./adata.db:/htdocs/epg/adata.db \
  -v ./config.php:/htdocs/epg/config.php \
  -p 5678:80 \
  --restart always \
  taksss/php-epg:latest
```

使用步骤 🛠️

在浏览器中打开 http://{服务器IP地址}:5678/epg/manage.php
默认密码为空，根据需要自行设置
添加 EPG 源地址， GitHub 源确保能够访问，点击 更新配置 保存
点击 更新数据库 拉取数据，点击 数据库更新日志 查看日志，点击 查看数据库 查看具体条目
设置 定时任务 ，点击 更新配置 保存，点击 定时任务日志 查看定时任务时间表
点击 更多设置 ，选择是否 生成xml文件 、生成方式 ，设置 限定频道节目单
用浏览器测试各个接口的返回结果是否正确：
- xmltv 接口： http://{服务器IP地址}:5678/epg/index.php
- DIYP&百川 接口： http://{服务器IP地址}:5678/epg/index.php?ch=CCTV1
- 超级直播 接口： http://{服务器IP地址}:5678/epg/index.php?channel=CCTV1
将 http://{服务器IP地址}:5678/epg/index.php 填入 DIYP、TiviMate 等软件的 EPG 地址栏
- ⚠️ 直接使用 docker run 运行的话，可以将 :5678/epg/index.php 替换为 :5678/epg。
- ⚠️ 部分软件不支持跳转解析 xmltv 文件，可直接使用 :5678/epg/t.xml.gz 访问。