php-epg

📺 PHP-EPG-Docker-Server

Docker Pulls Image Size

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

ℹ️ 主要功能

支持返回 DIYP & 百川 、 超级直播 以及 xmltv 格式 📡
提供 amd64 跟 arm64 、 armv7 架构镜像，支持 电视盒子 等设备 🐳
基镜像采用 alpine ，压缩后大小仅 20 MB 📦
兼容 SQLite 及 MySQL 数据库 🗃️
采用 先构建再存数据库 策略，减少数据冗余，提高读取速度 🚀
支持 繁体中文频道匹配 🌐
支持 双向模糊匹配 ✍🏻
支持 多对一频道映射 ，支持 正则表达式 🔄
支持设置 频道忽略字符表 🔇
支持生成 指定频道节目单 📝
内置 定时任务 ，支持设置定时拉取数据 ⏳
支持生成 匹配 M3U 的 xmltv 格式文件 💯
支持查看 频道匹配 结果 🪢
支持 频道指定 EPG 源 🈯
兼容多种 xmltv 格式 🗂️
包含网页设置页面 🌐
支持多个 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欧洲）

📝 更新日志

见CHANGELOG.md

TODO：

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

🚀 部署步骤

配置 Docker 环境
若已安装过，先删除旧版本并拉取新版本（注意备份数据）
```
docker rm php-epg -f && docker pull taksss/php-epg:latest
```
拉取镜像并运行：
```
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

同时部署 `MySQL` 、 `phpMyAdmin` 及 `php-epg`

方法1： 新建 docker-compose.yml 文件后，在同目录执行 docker-compose up -d

方法2： 依次执行以下指令：

docker run -d \
  --name mysql \
  -p 3306:3306 \
  -e MYSQL_ROOT_PASSWORD=root_password \
  -e MYSQL_DATABASE=phpepg \
  -e MYSQL_USER=phpepg \
  -e MYSQL_PASSWORD=phpepg \
  --restart always \
  mysql:8.0

docker run -d \
  --name phpmyadmin \
  -p 8080:80 \
  -e PMA_HOST=mysql \
  -e PMA_PORT=3306 \
  --link mysql:mysql \
  --restart always \
  phpmyadmin/phpmyadmin:latest

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

🛠️ 使用步骤

在浏览器中打开 http://{服务器IP地址}:5678/epg/manage.php
默认密码为空，根据需要自行设置
添加 EPG 源地址， GitHub 源确保能够访问，点击 更新配置 保存
点击 更新数据库 拉取数据，点击 数据库更新日志 查看日志，点击 查看数据库 查看具体条目
设置 定时任务 ，点击 更新配置 保存，点击 定时任务日志 查看定时任务时间表

建议从 凌晨1点 左右开始抓，很多源 00:00 ~ 00:30 都是无数据。隔 6 ~ 12 小时抓一次即可。
点击 更多设置 ，选择是否 生成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 或 :5678/epg/t.xml 访问。