PHP Classes

File: Abs_Xml_Rss/AbsRssReader20/class.AbsRssReader20.php

Recommend this page to a friend!
  Classes of Costin Trifan   Abs_Xml_Rss   Abs_Xml_Rss/AbsRssReader20/class.AbsRssReader20.php   Download  
File: Abs_Xml_Rss/AbsRssReader20/class.AbsRssReader20.php
Role: Class source
Content type: text/plain
Description: The base class
Class: Abs_Xml_Rss
Read and write RSS and Atom feeds
Author: By
Last change:
Date: 14 years ago
Size: 4,212 bytes
 

Contents

Class file image Download
<?php
/**
* class AbsRssReader20
*
* Parse an RSS 2.0 xml feed and retrieve the result as an associative array.
*
* @package Abs_Xml_Rss
* @category XML, RSS
* @author Costin Trifan <costintrifan@yahoo.com>
* @copyright 2009 Costin Trifan
* @licence http://en.wikipedia.org/wiki/MIT_License MIT License
* @version 1.0
*
* Copyright (c) 2009 Costin Trifan <http://june-js.com/>
*
* Permission is hereby granted, free of charge, to any person
* obtaining a copy of this software and associated documentation
* files (the "Software"), to deal in the Software without
* restriction, including without limitation the rights to use,
* copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following
* conditions:
*
* The above copyright notice and this permission notice shall be
* included in all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
* OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
* HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
* WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
* OTHER DEALINGS IN THE SOFTWARE.
*/
class AbsRssReader20
{
    private function
__clone(){}

   
// constructor
   
public function __construct(){}


   
/**
    * Holds the reference to the instance of the DOMDocument class
    * @type object
    */
   
protected static $_doc = null;

   
/**
    * Whether or not the xml document has been loaded.
    * @type bool
    * @access private
    */
   
protected static $_loaded = FALSE;



   
/**
    * Load the xml document
    * @param string $filePath The path to the xml document
    * @return void
    */
   
final public function Load( $filePath )
    {
        if (
is_null($filePath) or strlen($filePath) < 1)
            exit(
"Error in ".__CLASS__.'::'.__FUNCTION__.'<br/>The path to the rss file is missing!');

       
// LOAD XML DOCUMENT
       
self::$_doc = new DOMDocument();
        if (@
self::$_doc->load($filePath))
           
self::$_loaded = TRUE;
        else exit(
"Error: The rss file could not be opened!");
    }

   
/**
    * Get the channel tags as an associative array
    * @return array
    */
   
final public function GetChannelTags()
    {
       
$result = array();
        if ( !
self::$_loaded) return $result;

       
$ch = self::$_doc->getElementsByTagName('channel')->item(0);
        if ( !
is_null($ch))
        {
            if (
$ch->hasChildNodes())
            {
                foreach (
$ch->getElementsByTagName('*') as $tag)
                {
                   
// do not select item tags
                   
if ($tag->hasChildNodes() and ($tag->tagName <> 'item'))
                       
$result[$tag->tagName] = html_entity_decode($tag->nodeValue, ENT_QUOTES, 'UTF-8') ;
                }
            }
        }
        return
$result;
    }

   
/**
    * Get the channel items as an associative array
    *
    * @param int $maxLimit The maximum number of channel items to retrieve from the document.
    * If $maxLimit = 0 all records will be retrieved.
    * @return array
    */
   
final public function GetItems( $maxLimit = 0 )
    {
       
$result = array();
        if ( !
self::$_loaded) return $result;

       
$ch = self::$_doc->getElementsByTagName('channel')->item(0);
        if ( !
is_null($ch))
        {
            if (
$ch->hasChildNodes())
            {
               
$i = 0;
                foreach (
$ch->getElementsByTagName('item') as $tag)
                {
                   
$result['item_'.$i] = array();
                   
                    foreach (
$tag->getElementsByTagName('*') as $item)
                       
$result['item_'.$i][$item->tagName] = html_entity_decode($item->nodeValue, ENT_QUOTES, 'UTF-8') ;

                   
$i++;
                    if (
$maxLimit == $i) break;
                }
            }
        }
        return
$result;
    }

   
/**
    * Get all data from the rss feed as an associative array
    * @return array
    */
   
final public function GetAll()
    {
       
$result = array();
        if ( !
self::$_loaded) return $result;

       
$channelTags = $this->GetChannelTags();
       
$channelItems = $this->GetItems();

       
$result = array_merge($channelTags, $channelItems);

        return
$result;
    }

}
// >> END
?>