Feed/Abstract.php

Show:

inherited

Classes
- \Zend_Feed_Abstract

Table of Contents

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 [email protected] so we can send you a copy immediately.

Category: Zend
Copyright: Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
License: New BSD License
Package: Zend_Feed
Version: $Id: Abstract.php 25160 2012-12-18 15:17:16Z matthew $

\Zend_Feed_Abstract
jump to top

Package: Zend\Feed

The Zend_Feed_Abstract class is an abstract class representing feeds.

Zend_Feed_Abstract implements two core PHP 5 interfaces: ArrayAccess and Iterator. In both cases the collection being treated as an array is considered to be the entry collection, such that iterating over the feed takes you through each of the feed.s entries.

Implements
Parent(s): \Zend_Feed_Element
Children: \Zend_Feed_Rss; \Zend_Feed_Atom
Category: Zend
Copyright: Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
License: New BSD License

Properties

boolean $_appended = true

inherited

Inherited from: \Zend_Feed_Element::$$_appended

Default valuetrueDetails

Type: boolean
Inherited_from: \Zend_Feed_Element::$$_appended

\DOMElement $_element =

inherited

Inherited from: \Zend_Feed_Element::$$_element

Details

Type: \DOMElement
Inherited_from: \Zend_Feed_Element::$$_element

string $_encoding = 'UTF-8'

inherited<p>Character encoding to utilize</p>

Inherited from: \Zend_Feed_Element::$$_encoding

Default value'UTF-8'Details

Type: string
Inherited_from: \Zend_Feed_Element::$$_encoding

array $_entries =

Cache of feed entries.

Details

Type: array

integer $_entryIndex = 0

Current index on the collection of feed entries for the Iterator implementation.

Default value0Details

Type: integer

\Zend_Feed_Element $_parentElement =

inherited

Inherited from: \Zend_Feed_Element::$$_parentElement

Details

Type: \Zend_Feed_Element
Inherited_from: \Zend_Feed_Element::$$_parentElement

Methods

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

inherited

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.

__construct(string $uri = null, string $string = null, \Zend_Feed_Builder_Interface $builder = null) : void

Feed constructor

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.

__get(string $var) : mixed

inherited

Map variable access onto the underlying entry representation.

Inherited from: \Zend_Feed_Element::__get()

Get-style access returns a Zend_Feed_Element representing the child element accessed. To get string values, use method syntax with the __call() overriding.

Parameters

Name	Type	Description
$var	string	The property to access.

Returns

Type	Description
mixed

__isset(string $var) : boolean

inherited

Map isset calls onto the underlying entry representation.

Inherited from: \Zend_Feed_Element::__isset()

Parameters

Name	Type	Description
$var	string

Returns

Type	Description
boolean

__set(string $var, string $val) : void

inherited

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

__sleep() : array

Prepare for serialiation

Returns

Type	Description
array

__toString() : string

inherited

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

__unset(string $var) : void

inherited

Remove all children matching $var.

Inherited from: \Zend_Feed_Element::__unset()

Parameters

Name	Type	Description
$var	string

__wakeup() : void

Load the feed as an XML DOMDocument object

Throws

Exception	Description
\Zend_Feed_Exception

_buildEntryCache() : void

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

_children(string $var) : array

inherited

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

_importFeedFromString(string $feed) : string

Import a feed from a string

Protects against XXE attack vectors.

Parameters

Name	Type	Description
$feed	string

Returns

Type	Description
string

Throws

Exception	Description
\Zend_Feed_Exception	on detection of an XXE vector

_mapFeedEntries(\DOMElement $root, array $array) : \DOMElement

abstract

Generate the entries of the feed when working in write mode

Parameters

Name	Type	Description
$root	\DOMElement	the root node to use
$array	array	the data to use

Returns

Type	Description
\DOMElement	root node

_mapFeedHeaders(array $array) : \DOMElement

abstract

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

count() : integer

Get the number of entries in this feed object.

Returns

Type	Description
integer	Entry count.

current() : mixed

Required by the Iterator interface.

Returns

Type	Description
mixed	The current row, or null if no rows.

ensureAppended() : void

inherited

Appends this element to its parent if necessary.

Inherited from: \Zend_Feed_Element::ensureAppended()

getDOM() : \DOMDocument

inherited

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

getEncoding() : string

inherited

Get encoding

Inherited from: \Zend_Feed_Element::getEncoding()

Returns

Type	Description
string

key() : mixed

Required by the Iterator interface.

Returns

Type	Description
mixed	The current row number (starts at 0), or NULL if no rows

next() : mixed

Required by the Iterator interface.

Returns

Type	Description
mixed	The next row, or null if no more rows.

offsetExists(string $offset) : boolean

inherited

Required by the ArrayAccess interface.

Inherited from: \Zend_Feed_Element::offsetExists()

Parameters

Name	Type	Description
$offset	string

Returns

Type	Description
boolean

offsetGet(string $offset) : string

inherited

Required by the ArrayAccess interface.

Inherited from: \Zend_Feed_Element::offsetGet()

Parameters

Name	Type	Description
$offset	string

Returns

Type	Description
string

offsetSet(string $offset, string $value) : string

inherited

Required by the ArrayAccess interface.

Inherited from: \Zend_Feed_Element::offsetSet()

Parameters

Name	Type	Description
$offset	string
$value	string

Returns

Type	Description
string

offsetUnset(string $offset) : boolean

inherited

Required by the ArrayAccess interface.

Inherited from: \Zend_Feed_Element::offsetUnset()

Parameters

Name	Type	Description
$offset	string

Returns

Type	Description
boolean

rewind() : void

Required by the Iterator interface.

saveXml() : string

inherited

Get an XML string representation of this element

Inherited from: \Zend_Feed_Element::saveXml()

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

Returns

Type	Description
string

saveXmlFragment() : string

inherited

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

send() : void

abstract

Send feed to a http client with the correct header

Throws

Exception	Description
\Zend_Feed_Exception	if headers have already been sent

setDOM(\DOMElement $element) : void

inherited

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

setEncoding(string $value) : \Zend_Feed_Element

inherited

Set encoding

Inherited from: \Zend_Feed_Element::setEncoding()

Parameters

Name	Type	Description
$value	string	Encoding to use

Returns

Type	Description
\Zend_Feed_Element

setParent(\Zend_Feed_Element $element) : void

inherited

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

valid() : boolean

Required by the Iterator interface.

Returns

Type	Description
boolean	Whether the iteration is valid

Feed/Abstract.php

\Zend_Feed_Abstractjump to top

Properties

Methods

\Zend_Feed_Abstract
jump to top