rss
php/**//* * @(#)Rss2Gen.inc.php (beta) 2005/2/19 * * exblog RSS2 生成类，实现了RSS2规范中的大部分内容。 * * 使用方法请见本类底部（Rss2Gen类使用注释）信息。 * * 本程序为免费程序，源代码使用者可任意更改（请勿用于商业用途），但请保留本版权信息! * * @author HexUzHoNG <hexuzhong> * @version beta-2, 2005-03-11 * @since exBlog-1.3.0 * */ class Rss2Gen { var $rss_header; //RSS文档头，存放一个<rss>根元素及其version属性。 var $item; // var $items; var $channel_header; //频道的头部信息，存放频道名称、URL、描述、语言、版权等等。 //--------------- 以下元素是可选的频道子元素 --------------// var $channel_language; //频道使用的语言种类，例如en-us、zh-cn等，放便聚集器组织中一语言的站点。 var $channel_copyright; //频道内容的版权声明。 var $channel_managingEditor; //对该频道内容负责的个人的Email地址 var $channel_webMaster; //对该频道的技术支持负责的个人的Email地址 var $channel_pubDate; //该频道内容的公布日期 var $channel_lastBuildDate; //上次频道内容更改的时间 var $channel_category; //说明频道属于哪一个或多个分类 var $channel_generator = "<generator>exblog RSS2 builder</generator>"; //用于生成该频道的程序 var $channel_docs; //RSS文件所使用格式的说明文档所在的URL var $channel_cloud; //允许进程注册为“cloud”，频道更新时通知它 var $channel_ttl; //ttl 代表存活时间，存活时间是一个数字，表示提要在刷新之前缓冲的分钟数 var $channel_image; //指定一个能在频道中显示的GIF、JPEG 或PNG 图像 //var $channel_rating; //关于该频道的 PICS 评价 //var $channel_textInput; //定义可与频道一起显示的输入框 //var $channel_skipHours; //告诉聚集器哪些小时的更新可以忽略 //var $channel_skipDays; //告诉聚集器那一天的更新可以忽略 var $channel; //整个rss2文档信息，用与生成整个页面。 var $halt_on_error = true; /**//** * 构造函数，其参数皆为rss2必须的频道子元素，如果不填，则为默认内容。 * * @param String $title 频道的名称，频道的title应该和web站点的title尽量一致。 * @param String $link 与该频道关联的web站点的URL。 * @param String $description 对频道的一段简单描述，如介绍频道是做什么的。 * @access public */ function Rss2Gen() { $this->fillHeader(); } /**//** * 生成RSS文档头，必须以一个<rss>元素作为根元素，其有一个强制属性version，指定当前文档遵守的RSS版本。 * @access private */ function fillHeader() { $this->rss_header = "</rss></rss></hexuzhong><font face="新宋体"><span style="BORDER-BOTTOM: #ffffff 1px solid; BACKGROUND-COLOR: #eeeeee"><span style="COLOR: #0000bb"></span><span style="COLOR: #0000bb">xml</span><span style="COLOR: #0000bb"> </span><span style="COLOR: #0000bb">version</span><span style="COLOR: #007700">=</span><span style="COLOR: #007700">"</span><span style="COLOR: #0000bb">1</span><span style="COLOR: #0000bb">.</span><span style="COLOR: #0000bb">0</span><span style="COLOR: #0000bb">"</span><span style="COLOR: #0000bb"> </span><span style="COLOR: #0000bb">encoding</span><span style="COLOR: #0000bb">=</span><span style="COLOR: #0000bb">"</span><span style="COLOR: #0000bb">gb2312</span><span style="COLOR: #0000bb">"</span><span style="COLOR: #0000bb">?></span></span><br></font>rn"; $this->rss_header .= " <rss version="2.0">rn"; } /**//** * 设置频道头，其中三个元素为必须的。 * @param String $title 频道的名称，频道的title应该和Web站点的title尽量一致。 * @param String $link 与该频道关联的Web站点或者站点区域的URL。 * @param String $description 对频道的一段简单描述，简要介绍频道是做什么的。 */ function setChannel($title = "exblog", $link = "http://www.exblog.org", $description = "exblog") { $this->channel_header = " <title></title>n"; $this->channel_header .= " <link>".$link."rn"; $this->channel_header .= " <description></description>rn"; } function halt($msg) { if ($this->halt_on_error) { $this->haltmsg($msg); } die("exblog RSS2 exit"); } function haltmsg($msg) { sprintf("<b>exblog RSS2 builder ERROR: %s</b><br>rn", $msg); } /**//** * 设置该RSS文档的语言，默认为简体中文。 * @access public */ function setLanguage($lang = "zh_cn") { $this->channel_language = " <language>".$lang."</language>rn"; } /**//** * 频道内容的版权声明 * @access public */ function setCopyright($copyright = "exblog") { $this->channel_copyright = " <copyright>".$copyright."</copyright>rn"; } /**//** * 对该频道内容负责的个人的Email地址 * @access public */ function setManagingEditor($email = NULL) { if (empty($email)) { $this->halt("如果你设置了该频道内容负责的个人的Email地址，请填写她。"); } $this->channel_managingEditor = " <managingeditor>".$email."</managingeditor>rn"; } /**//** * 对该频道的技术支持负责的个人的Email地址 * @access public */ function setWebMaster($email = NULL) { if (empty($email)) { $this->halt("如果你设置了该频道的技术支持负责的个人的Email地址，请填写她。 :)"); } $this->channel_webMaster = " <webmaster>".$email."</webmaster>rn"; } /**//** * 该频道内容的公布日期。 * @access public */ function setPubDate($date = NULL) { if (empty($date)) { $date = date("Y/m/d"); $this->channel_pubDate = " <pubdate>".$date."</pubdate>rn"; } $this->channel_pubDate = " <pubdate>".$date."</pubdate>rn"; } /**//** * 上次频道内容更改的时间 * @access public */ function setLastBuildDate($date = NULL) { if (empty($date)) { $date = date("Y/m/d"); $this->channel_lastBuildDate = " <lastbuilddate>".$date."</lastbuilddate>rn"; } $this->channel_lastBuildDate = " <lastbuilddate>".$date."</lastbuilddate>rn"; } /**//** * 说明频道属于哪一个或多个分类 * @access public */ function setCategory($category) { $this->channel_category = " <category>".$category."</category>rn"; } /**//** * RSS文件所使用格式的说明文档所在的URL * @access public */ function setDocs($url) { $this->channel_docs = " <docs>".$url."</docs>rn"; } /**//** * ttl 代表存活时间，存活时间是一个数字，表示提要在刷新之前缓冲的分钟数 * @access public */ function setTtl($minute) { $this->channel_ttl = " <ttl>".$minute."</ttl>rn"; } /**//** * 指定一个能在频道中显示的GIF、JPEG 或PNG 图像 * * @param String $url 必需，是表示该频道的 GIF、JPEG 或 PNG 图像的URL * @param String $title 必需，是图象的描述。当频道以 HTML 呈现时，用作 HTML <image> 标签的 ALT 属性。 * @param String $link 必需，是站点的 URL。如果频道以 HTML 呈现，该图像作为到这个站点的链接。 * @param Integer $width 表示图象的像素宽，必须和 $height 一同设置，否则不会显示此属性。 * @param Integer $height 表示图象的像素高，必须和 $width 一同设置，否则不会显示此属性。 * @param String $description 围绕着该图像形成的链接元素的 title 属性。 * * @access public */ function setChannelImage($url, $title, $link, $width = NULL, $height = NULL, $description = NULL) { if (!isset($url)) $this->halt("如果你要设置图片，该图像地址属性必须填写。"); if (!isset($title)) $this->halt("如果你要设置图片，该图像描述属性必须填写。"); if (!isset($link)) $this->halt("如果你要设置图片，该图像链接属性必须填写。这个URL一般和图像地址属性相同"); $this->channel_image = " <image>rn"; $this->channel_image .= " <url>".$url."</url>rn"; $this->channel_image .= " <title></title>rn"; $this->channel_image .= " <link>".$link."rn"; //如果设置了图像宽、高则添加此属性。 if (!empty($width) && !empty($height)) { $this->channel_image .= " <width>".$width."</width>rn"; $this->channel_image .= " <height>".$height."</height>rn"; } if (!empty($description)) $this->channel_image .= " <description></description>rn"; $this->channel_image .= "</image>rn"; } /**//** * 添加一条item到channel中，虽然item的子元素都是可选的，但至少要存在一个title或description * * @param String $title 项（item）的标题 * @param String $description 项（item）的大纲 * @param String $link 项（item）的URL * @param String $author 项（item）作者的Email 地址 * @param String $category 包括项（item）的一个或多个分类 * @param String $comments 关于项（item）的注释页的URL * @param String $enclosure 支持和该项（item）有关的媒体对象 * @param String $guid 唯一与该项（item）联系在一起的永久性链接 * @param String $pubDate 该项（item）是什么时候发布的 * @param String $Source 该项（item）来自哪个RSS 频道，当把项（item）聚合在一起时非常有用 * * @access public */ function addItem($title = NULL, $description = NULL, $link = NULL, $author = NULL, $category = NULL, $comments = NULL, $enclosure = NULL, $guid = NULL, $pubDate = NULL, $source = NULL) { //判断是否至少添加了title或description if (empty($title) && empty($description)) { $this->halt("item:请至少设置title或description属性。"); } else { $this->item = " <item>rn"; if (!empty($title)) $this->item .= " <title></title>rn"; if (!empty($link)) $this->item .= " <link>".$link."rn"; if (!empty($description)) $this->item .= " <description></description>rn"; if (!empty($author)) $this->item .= " <author></author>rn"; if (!empty($category)) $this->item .= " <category></category>rn"; if (!empty($comments)) $this->item .= " <comments></comments>rn"; if (!empty($enclosure)) $this->item .= " <enclosure></enclosure>rn"; if (!empty($guid)) $this->item .= " <guid>".$guid."</guid>rn"; if (!empty($pubDate)) $this->item .= " <pubdate>".$pubDate."</pubdate>rn"; if (!empty($source)) $this->item .= " <source></source>rn"; $this->item .= "</item>rn"; } $this->items .= $this->item; } /**//** * 输出 rss2 文档 */ function builder() { $this->stuff(); header("Content-type:application/xml"); print $this->channel; } /**//** * 兼容老版本rss生成方法，去掉了写文件功能。 * */ function buildRssFeed($param = NULL) { $this->builder(); } /**//** * 合成整个RSS2文档 * */ function stuff() { $this->channel = $this->rss_header; $this->channel .= $this->channel_header; if (isset($this->channel_language)) $this->channel .= $this->channel_language; if (isset($this->channel_copyright)) $this->channel .= $this->channel_copyright; if (isset($this->channel_managingEditor)) $this->channel .= $this->channel_managingEditor; if (isset($this->channel_webMaster)) $this->channel .= $this->channel_webMaster; if (isset($this->channel_pubDate)) $this->channel .= $this->channel_pubDate; if (isset($this->channel_lastBuildDate)) $this->channel .= $this->channel_lastBuildDate; if (isset($this->channel_category)) $this->channel .= $this->channel_category; if (isset($this->channel_docs)) $this->channel .= $this->channel_docs; if (isset($this->channel_cloud)) $this->channel .= $this->channel_cloud; if (isset($this->channel_ttl)) $this->channel .= $this->channel_ttl; if (isset($this->channel_image)) $this->channel .= $this->channel_image; $this->channel .= $this->channel_generator; $this->channel .= $this->items; $this->channel .= "</image></rss>rn"; } } /**//******************************* Rss2Gen 类使用注释 *******************/ /**//* $rss2gen = new Rss2Gen(); $rss2gen->setChannel("exblog222rss", "http://elliott.fengling.net", "elliott rss2gen"); //以下部分为可添加信息 //$rss2gen->setLanguage("zh-cn"); //$rss2gen->setCopyright("exblog @"); //$rss2gen->setManagingEditor("elliott_hee@163.com"); //$rss2gen->setWebMaster("elliott@yeah.net"); //$rss2gen->setPubDate(); //$rss2gen->setLastBuildDate(); //$rss2gen->setCategory("none"); //$rss2gen->setDocs("http://www.exblog.org/rss_docs.html"); //$rss2gen->setTtl(600); //$rss2gen->setChannelImage("/XrssFile/2006-9/24/200692413947513.gif", "demo~~ :)", "http://www.exblog.org"); //------------------------ //---添加一条记录到rss文档中，至少需要一个参数，title或description $rss2gen->addItem("item1", "item1's description", "http://www.exblog.org/?play=1", "elliott", "默认分类", "描述呀描述。", "支持和该项（item）有关的媒体对象", "唯一与该项（item）联系在一起的永久性链接", "2005-03-12", "该项（item）来自哪个RSS 频道，当把项（item）聚合在一起时非常有用"); $rss2gen->addItem("item2", "item2's description"); $rss2gen->addItem("item3"); $rss2gen->builder(); //兼容老版本中方法 //$rss2gen->buildRssFeed(); */
![[Web front-end] Node.js quick start](https://img.php.cn/upload/course/000/000/067/662b5d34ba7c0227.png)
