🍰 万物皆可 RSS
RSSHub 是一个轻量、易于扩展的 RSS 生成器,可以给任何奇奇怪怪的内容生成 RSS 订阅源
这里是她的 PHP 版本,开坑就是因为 DIY 太会咕了 (x
插件列表 Plugins.md
明知道开了坑也没生态但还要开的是不是应该叫傻子呢 (小声
如果有任何想法或需求,可以在 issue 中告诉我们,同时我们欢迎各种 pull requests
因为作者是辣鸡高中生,所以各种消息回复得比较慢,还望谅解
-
在 /plugins/ 里添加对应分类 (若不存在)
-
在 /plugins/分类名 中添加获取 RSS 内容的脚本
-
更新文档: /Plugins.md
可参考 /plugins/example/example.php 范例插件
每个类的命名空间为 RSSHub\Plugins\分类名
每个类都需要定义公开属性 $_info , 其中包括 routes 路由表, 如下
public $_info = [
'routes' => [
'test/:input1/:input2' => 'input',
],
];- 键
test/:input1/:input2代表在该插件分类中(example), 定义名为test的路由, 输入参数为input1与input2 - 值
input代表处理该条请求的函数方法为input注意:该方法必须为静态方法且在该类中 - 最终访问地址: https://xx.xx/分类名/test/input-value1/input-value2
RSSHub\Lib\XML::toRSS($list) 用于生成标准化的 RSS 内容,本质是 mibe/FeedWriter ,开发者亦可直接使用该类库
- 输入参数数组包含
titledescriptionimage以及itemsimage又包含urlsrc以及title, 该参数若不需要可直接忽略items是内容数组 , 格式如下title标题linkURL 链接date时间戳description内容
RSSHub\Lib\Cache::getCache($md5,$func) 用于获取或新增缓存内容
- 输入参数
$md5: 唯一 id ,用于区分缓存内容$func: callable 类型, 传递获取缓存内容的函数方法,无参数
- 缓存时间: 默认 5 分钟
- 使用方法: 如下
use RSSHub\Lib\Cache;
$data = Cache::getCache($md5,function () use ($var1)
{
$curl = new Curl();
$curl->setOpt(CURLOPT_SSL_VERIFYPEER,0);
$curl->setOpt(CURLOPT_SSL_VERIFYHOST,0);
$data = json_decode(json_encode($curl->get("https://xx.xx/{$var1}")),true);
return $data;
});Curl\Curl CURL 方法,本质为 php-curl-class/php-curl-class
若在处理过程中遇到错误,直接抛出 RSSHub\Lib\Exception 异常即可,第一位输入参数为消息,第二位为等级(可选 warning 以及 error)
输出时会自动添加 XML header, 请勿重复添加
git clone https://github.com/LoliLin/RSSHub.gitcomposer install- 设置运行目录为
public - 重命名.env.example为.env
- 配置伪静态规则 (nginx 规则如下)
rewrite ^(.*)$ /index.php?s=$1 last;演示站,可随意使用