API Documentation

Feed/Rss.php

Zend Framework

LICENSE

This source file is subject to the new BSD license that is bundled with this package in the file LICENSE.txt. It is also available through the world-wide-web at this URL: http://framework.zend.com/license/new-bsd If you did not receive a copy of the license and are unable to obtain it through the world-wide-web, please send an email to license@zend.com so we can send you a copy immediately.

category
Zend  
copyright
Copyright (c) 2005-2011 Zend Technologies USA Inc. (http://www.zend.com)  
license
New BSD License  
package
Zend_Feed  
version
$Id: Rss.php 23775 2011-03-01 17:25:24Z ralph $  

\Zend_Feed_Rss

RSS channel class

The Zend_Feed_Rss class is a concrete subclass of Zend_Feed_Abstract meant for representing RSS channels. It does not add any methods to its parent, just provides a classname to check against with the instanceof operator, and expects to be handling RSS-formatted data instead of Atom.

Extends from
\Zend_Feed_Abstract
category
Zend  
copyright
Copyright (c) 2005-2011 Zend Technologies USA Inc. (http://www.zend.com)  
license
New BSD License  
package
Zend_Feed  

Properties

Propertyprotectedstring  $_defaultNamespace= 'rss'

The default namespace for RSS channels.

Default valuerssDetails
Type
string
Propertyprotectedstring  $_entryClassName= 'Zend_Feed_Entry_Rss'

The classname for individual channel elements.

Default valueZend_Feed_Entry_RssDetails
Type
string
Propertyprotectedstring  $_entryElementName= 'item'

The element name for individual channel elements (RSS <item>s).

Default valueitemDetails
Type
string

Methods

methodpublic__call( string $var, mixed $unused ) : mixed

Get the value of an element with method syntax.

Inherited from: \Zend_Feed_Element::__call()

Map method calls to get the string value of the requested element. If there are multiple elements that match, this will return an array of those objects.

Parameters
Name Type Description
$var string The element to get the string value of.
$unused mixed This parameter is not used.
Returns
Type Description
mixed The node's value, null, or an array of nodes.
methodpublic__construct( string $uri = null, string $string = null, \Zend_Feed_Builder_Interface $builder = null ) : void

Feed constructor

Inherited from: \Zend_Feed_Abstract::__construct()

The Zend_Feed_Abstract constructor takes the URI of a feed or a feed represented as a string and loads it as XML.

Parameters
Name Type Description
$uri string The full URI of the feed to load, or NULL if not retrieved via HTTP or as an array.
$string string The feed as a string, or NULL if retrieved via HTTP or as an array.
$builder \Zend_Feed_Builder_Interface The feed as a builder instance or NULL if retrieved as a string or via HTTP.
Throws
Exception Description
\Zend_Feed_Exception If loading the feed failed.
methodpublic__get( string $var ) : mixed

Make accessing some individual elements of the channel easier.

Special accessors 'item' and 'items' are provided so that if you wish to iterate over an RSS channel's items, you can do so using foreach ($channel->items as $item) or foreach ($channel->item as $item).

Parameters
Name Type Description
$var string The property to access.
Returns
Type Description
mixed
methodpublic__isset( string $var ) : boolean

Map isset calls onto the underlying entry representation.

Inherited from: \Zend_Feed_Element::__isset()
Parameters
Name Type Description
$var string
Returns
Type Description
boolean
methodpublic__set( string $var, string $val ) : void

Map variable sets onto the underlying entry representation.

Inherited from: \Zend_Feed_Element::__set()
Parameters
Name Type Description
$var string The property to change.
$val string

The property's new value.

Throws
Exception Description
\Zend_Feed_Exception
methodpublic__sleep( ) : array

Prepare for serialiation

Inherited from: \Zend_Feed_Abstract::__sleep()
Returns
Type Description
array
methodpublic__toString( ) : string

Returns the nodeValue of this element when this object is used in a string context.

Inherited from: \Zend_Feed_Element::__toString()
Returns
Type Description
string
methodpublic__unset( string $var ) : void

Remove all children matching $var.

Inherited from: \Zend_Feed_Element::__unset()
Parameters
Name Type Description
$var string
methodpublic__wakeup( ) : void

Override Zend_Feed_Abstract to set up the $_element and $_entries aliases.

Throws
Exception Description
\Zend_Feed_Exception
methodprotected_buildEntryCache( ) : void

Cache the individual feed elements so they don't need to be searched for on every operation.

Inherited from: \Zend_Feed_Abstract::_buildEntryCache()
methodprivate_buildiTunes( \DOMElement $root, array $array ) : void

Adds the iTunes extensions to a root node

Parameters
Name Type Description
$root \DOMElement
$array array
methodprotected_children( string $var ) : array

Finds children with tagnames matching $var

Inherited from: \Zend_Feed_Element::_children()

Similar to SimpleXML's children() method.

Parameters
Name Type Description
$var string Tagname to match, can be either namespace:tagName or just tagName.
Returns
Type Description
array
methodprotected_mapFeedEntries( \DOMElement $root, array $array ) : void

Generate the entries of the feed when working in write mode

The following nodes are constructed for each feed entry entry title url to feed entry url to feed entry short text long version, can contain html

Parameters
Name Type Description
$root \DOMElement the root node to use
$array array the data to use
methodprotected_mapFeedHeaders( array $array ) : \DOMElement

Generate the header of the feed when working in write mode

Parameters
Name Type Description
$array array the data to use
Returns
Type Description
\DOMElement root node
methodpubliccount( ) : integer

Get the number of entries in this feed object.

Inherited from: \Zend_Feed_Abstract::count()
Returns
Type Description
integer Entry count.
methodpubliccurrent( ) : mixed

Required by the Iterator interface.

Inherited from: \Zend_Feed_Abstract::current()
Returns
Type Description
mixed The current row, or null if no rows.
methodprotectedensureAppended( ) : void

Appends this element to its parent if necessary.

Inherited from: \Zend_Feed_Element::ensureAppended()
methodpublicgetDOM( ) : \DOMDocument

Get a DOM representation of the element

Inherited from: \Zend_Feed_Element::getDOM()

Returns the underlying DOM object, which can then be manipulated with full DOM methods.

Returns
Type Description
\DOMDocument
methodpublicgetEncoding( ) : string

Get encoding

Inherited from: \Zend_Feed_Element::getEncoding()
Returns
Type Description
string
methodpublickey( ) : mixed

Required by the Iterator interface.

Inherited from: \Zend_Feed_Abstract::key()
Returns
Type Description
mixed The current row number (starts at 0), or NULL if no rows
methodpublicnext( ) : mixed

Required by the Iterator interface.

Inherited from: \Zend_Feed_Abstract::next()
Returns
Type Description
mixed The next row, or null if no more rows.
methodpublicoffsetExists( string $offset ) : boolean

Required by the ArrayAccess interface.

Inherited from: \Zend_Feed_Element::offsetExists()
Parameters
Name Type Description
$offset string
Returns
Type Description
boolean
methodpublicoffsetGet( string $offset ) : string

Required by the ArrayAccess interface.

Inherited from: \Zend_Feed_Element::offsetGet()
Parameters
Name Type Description
$offset string
Returns
Type Description
string
methodpublicoffsetSet( string $offset, string $value ) : string

Required by the ArrayAccess interface.

Inherited from: \Zend_Feed_Element::offsetSet()
Parameters
Name Type Description
$offset string
$value string
Returns
Type Description
string
methodpublicoffsetUnset( string $offset ) : boolean

Required by the ArrayAccess interface.

Inherited from: \Zend_Feed_Element::offsetUnset()
Parameters
Name Type Description
$offset string
Returns
Type Description
boolean
methodpublicrewind( ) : void

Required by the Iterator interface.

Inherited from: \Zend_Feed_Abstract::rewind()
methodpublicsaveXml( ) : string

Override Zend_Feed_Element to include root node

Returns a string of this element's XML, including the XML prologue.

Returns
Type Description
string
methodpublicsaveXmlFragment( ) : string

Get the XML for only this element

Inherited from: \Zend_Feed_Element::saveXmlFragment()

Returns a string of this element's XML without prologue.

Returns
Type Description
string
methodpublicsend( ) : void

Send feed to a http client with the correct header

Throws
Exception Description
\Zend_Feed_Exception if headers have already been sent
methodpublicsetDOM( \DOMElement $element ) : void

Update the object from a DOM element

Inherited from: \Zend_Feed_Element::setDOM()

Take a DOMElement object, which may be originally from a call to getDOM() or may be custom created, and use it as the DOM tree for this Zend_Feed_Element.

Parameters
Name Type Description
$element \DOMElement
methodpublicsetEncoding( string $value ) : \Zend_Feed_Element

Set encoding

Inherited from: \Zend_Feed_Element::setEncoding()
Parameters
Name Type Description
$value string Encoding to use
Returns
Type Description
\Zend_Feed_Element
methodpublicsetParent( \Zend_Feed_Element $element ) : void

Set the parent element of this object to another Zend_Feed_Element.

Inherited from: \Zend_Feed_Element::setParent()
Parameters
Name Type Description
$element \Zend_Feed_Element
methodpublicvalid( ) : boolean

Required by the Iterator interface.

Inherited from: \Zend_Feed_Abstract::valid()
Returns
Type Description
boolean Whether the iteration is valid
Documentation was generated by DocBlox 0.13.3.