shikiryu / shikiryurss

一个 RSS 阅读器和写入器

dev-master 2023-04-19 15:03 UTC

This package is auto-updated.

Last update: 2024-09-19 18:01:51 UTC


README

PHP 库读取和创建 RSS

免责声明:此类功能正常。但是,只有在没有其他选择时才使用它。
例如,Zend 和 Symfony 都有自己的 RSS 工厂,不要添加另一个。

📚 目录

📦 安装

composer install shikiryu/shikiryurss

include '/path/to/this/library/autoload.php';

🚀 使用

如何让它读取 RSS?

首先,我们需要加载 RSS

$rss = SRSS::read('http://exemple.com/rss.xml');

很简单,对吧?然后你可以提取一般信息

echo $rss->title; // will display blog title

然后,你可以处理文章。你可以选择一个精确的文章

$article1 = $rss->getItem(1); // or $rss->getFirst();

或者循环它们

foreach($rss as $article) {
    echo '<a href="'.$article->link.'">'. SRSSTools::formatDate('d/m/y', $item->pubDate).' '.$item->title.'';
}

如果你喜欢数组,你可以将 RSS 转换为数组

$rssArray = $rss->toArray();

你也可以用下面的方法将它保存到你的服务器上

$rss->save('/www/rss/rss.xml'); // example

或者最后,你可以用下面的方法显示它

$rss->show();

如何让它创建 RSS?

首先,我们需要初始化 RSS

$rss = SRSS::create();

很简单,对吧?然后你可以添加一般信息

$rss->title = 'My Awesome Blog';
$rss->link = 'http://shikiryu.com/devblog/';
$rss->description = 'is awesome';

这三个是验证你的 RSS 所必需的,其他选项可以添加。然后,你可以添加文章。让我们假设 $content 包含从你的数据库中获取的数组。

foreach($content as $item){
    $rssitem = new Item(); // we create an item
    $rssitem->title = $item["title"]; // adding title (option)
    $rssitem->link = $item['link']; // adding link (option)
    $rssitem->pubDate = $item["date"]; // date automatically transformed into RSS format (option)
    $rssitem->description = $item["text"]; // adding description (mandatory)
    $rss->addItem($rssitem); // we add the item into our RSS
}

有两个函数可以添加条目。第一个将按照你输入的顺序从上到下添加条目。

$rss->addItem($item);

另一个函数则相反,将下一个条目添加到 RSS 的顶部。

$rss->addItemBefore($item);

✨ 功能

读取每个 RSS 2.0
基于 RSS 2.0 规范。
编写和验证 RSS 2.0 文件
基于 RSS 2.0 规范。

🛠️ 支持

打开一个问题以获得支持。

📝 贡献

请使用Github Flow进行贡献。创建分支,添加提交,然后打开一个拉取请求

📜 许可

Creative Commons Attribution NonCommercial (CC-BY-NC) © Chouchen

所有文档在 http://labs.shikiryu.com/SRSS/#_how

联系方式: https://shikiryu.com/contact