system/helpers/feed.php

   1 <?php defined('SYSPATH') OR die('No direct access allowed.');
   2 /**
   3  * Feed helper class.
   4  *
   5  * $Id: feed.php 3917 2009-01-21 03:06:22Z zombor $
   6  *
   7  * @package    Core
   8  * @author     Kohana Team
   9  * @copyright  (c) 2007-2008 Kohana Team
  10  * @license    http://kohanaphp.com/license.html
  11  */
  12 class feed {
  13
  14         /**
  15          * Parses a remote feed into an array.
  16          *
  17          * @param   string   remote feed URL
  18          * @param   integer  item limit to fetch
  19          * @return  array
  20          */
  21         public static function parse($feed, $limit = 0)
  22         {
  23                 // Make limit an integer
  24                 $limit = (int) $limit;
  25
  26                 // Disable error reporting while opening the feed
  27                 $ER = error_reporting(0);
  28
  29                 // Allow loading by filename or raw XML string
  30                 $load = (is_file($feed) OR valid::url($feed)) ? 'simplexml_load_file' : 'simplexml_load_string';
  31
  32                 // Load the feed
  33                 $feed = $load($feed, 'SimpleXMLElement', LIBXML_NOCDATA);
  34
  35                 // Restore error reporting
  36                 error_reporting($ER);
  37
  38                 // Feed could not be loaded
  39                 if ($feed === FALSE)
  40                         return array();
  41
  42                 // Detect the feed type. RSS 1.0/2.0 and Atom 1.0 are supported.
  43                 $feed = isset($feed->channel) ? $feed->xpath('//item') : $feed->entry;
  44
  45                 $i = 0;
  46                 $items = array();
  47
  48                 foreach ($feed as $item)
  49                 {
  50                         if ($limit > 0 AND $i++ === $limit)
  51                                 break;
  52
  53                         $items[] = (array) $item;
  54                 }
  55
  56                 return $items;
  57         }
  58
  59         /**
  60          * Creates a feed from the given parameters.
  61          *
  62          * @param   array   feed information
  63          * @param   array   items to add to the feed
  64          * @return  string
  65          */
  66         public static function create($info, $items, $format = 'rss2')
  67         {
  68                 $info += array('title' => 'Generated Feed', 'link' => '', 'generator' => 'KohanaPHP');
  69
  70                 $feed = '<?xml version="1.0"?><rss version="2.0"><channel></channel></rss>';
  71                 $feed = simplexml_load_string($feed);
  72
  73                 foreach ($info as $name => $value)
  74                 {
  75                         if (($name === 'pubDate' OR $name === 'lastBuildDate') AND (is_int($value) OR ctype_digit($value)))
  76                         {
  77                                 // Convert timestamps to RFC 822 formatted dates
  78                                 $value = date(DATE_RFC822, $value);
  79                         }
  80                         elseif (($name === 'link' OR $name === 'docs') AND strpos($value, '://') === FALSE)
  81                         {
  82                                 // Convert URIs to URLs
  83                                 $value = url::site($value, 'http');
  84                         }
  85
  86                         // Add the info to the channel
  87                         $feed->channel->addChild($name, $value);
  88                 }
  89
  90                 foreach ($items as $item)
  91                 {
  92                         // Add the item to the channel
  93                         $row = $feed->channel->addChild('item');
  94
  95                         foreach ($item as $name => $value)
  96                         {
  97                                 if ($name === 'pubDate' AND (is_int($value) OR ctype_digit($value)))
  98                                 {
  99                                         // Convert timestamps to RFC 822 formatted dates
 100                                         $value = date(DATE_RFC822, $value);
 101                                 }
 102                                 elseif (($name === 'link' OR $name === 'guid') AND strpos($value, '://') === FALSE)
 103                                 {
 104                                         // Convert URIs to URLs
 105                                         $value = url::site($value, 'http');
 106                                 }
 107
 108                                 // Add the info to the row
 109                                 $row->addChild($name, $value);
 110                         }
 111                 }
 112
 113                 return $feed->asXML();
 114         }
 115
 116 } // End feed