rss
php/**//* * @(#)rss2gen.inc.php (beta) 2005/2/19 * * exblog rss2 生成类，实现了rss2规范中的大部分内容。 * * 使用方法请见本类底部（rss2gen类使用注释）信息。 * * 本程序为免费程序，源代码使用者可任意更改（请勿用于商业用途），但请保留本版权信息! * * @author hexuzhong * @version beta-2, 2005-03-11 * @since exblog-1.3.0 * */ class rss2gen { var $rss_header; //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 = exblog rss2 builder; //用于生成该频道的程序 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文档头，必须以一个元素作为根元素，其有一个强制属性version，指定当前文档遵守的rss版本。 * @access private */ function fillheader() { $this->rss_header =
xml version=1.0 encoding=gb2312?>
rn; $this->rss_header .= 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 = n; $this->channel_header .= .$link.rn; $this->channel_header .= rn; } function halt($msg) { if ($this->halt_on_error) { $this->haltmsg($msg); } die(exblog rss2 exit); } function haltmsg($msg) { sprintf(exblog rss2 builder error: %s
rn, $msg); } /**//** * 设置该rss文档的语言，默认为简体中文。 * @access public */ function setlanguage($lang = zh_cn) { $this->channel_language = .$lang.rn; } /**//** * 频道内容的版权声明 * @access public */ function setcopyright($copyright = exblog) { $this->channel_copyright = .$copyright.rn; } /**//** * 对该频道内容负责的个人的email地址 * @access public */ function setmanagingeditor($email = null) { if (empty($email)) { $this->halt(如果你设置了该频道内容负责的个人的email地址，请填写她。); } $this->channel_managingeditor = .$email.rn; } /**//** * 对该频道的技术支持负责的个人的email地址 * @access public */ function setwebmaster($email = null) { if (empty($email)) { $this->halt(如果你设置了该频道的技术支持负责的个人的email地址，请填写她。 :)); } $this->channel_webmaster = .$email.rn; } /**//** * 该频道内容的公布日期。 * @access public */ function setpubdate($date = null) { if (empty($date)) { $date = date(y/m/d); $this->channel_pubdate = .$date.rn; } $this->channel_pubdate = .$date.rn; } /**//** * 上次频道内容更改的时间 * @access public */ function setlastbuilddate($date = null) { if (empty($date)) { $date = date(y/m/d); $this->channel_lastbuilddate = .$date.rn; } $this->channel_lastbuilddate = .$date.rn; } /**//** * 说明频道属于哪一个或多个分类 * @access public */ function setcategory($category) { $this->channel_category = .$category.rn; } /**//** * rss文件所使用格式的说明文档所在的url * @access public */ function setdocs($url) { $this->channel_docs = .$url.rn; } /**//** * ttl 代表存活时间，存活时间是一个数字，表示提要在刷新之前缓冲的分钟数 * @access public */ function setttl($minute) { $this->channel_ttl = .$minute.rn; } /**//** * 指定一个能在频道中显示的gif、jpeg 或png 图像 * * @param string $url 必需，是表示该频道的 gif、jpeg 或 png 图像的url * @param string $title 必需，是图象的描述。当频道以 html 呈现时，用作 html 标签的 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 = rn; $this->channel_image .= .$url.rn; $this->channel_image .= rn; $this->channel_image .= .$link.rn; //如果设置了图像宽、高则添加此属性。 if (!empty($width) && !empty($height)) { $this->channel_image .= .$width.rn; $this->channel_image .= .$height.rn; } if (!empty($description)) $this->channel_image .= rn; $this->channel_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 = rn; if (!empty($title)) $this->item .= rn; if (!empty($link)) $this->item .= .$link.rn; if (!empty($description)) $this->item .= rn; if (!empty($author)) $this->item .= rn; if (!empty($category)) $this->item .= rn; if (!empty($comments)) $this->item .= rn; if (!empty($enclosure)) $this->item .= rn; if (!empty($guid)) $this->item .= .$guid.rn; if (!empty($pubdate)) $this->item .= .$pubdate.rn; if (!empty($source)) $this->item .= rn; $this->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 .= 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(); */