Feed/Abstract.php

Show: PublicProtectedPrivateinherited
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 license@zend.com 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

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

>VPropertyprotectedboolean $_appended = true
inherited
Inherited from: \Zend_Feed_Element::$$_appended
Default valuetrueDetails
Type
boolean
Inherited_from
\Zend_Feed_Element::$$_appended  
>VPropertyprotected\DOMElement $_element
inherited
Inherited from: \Zend_Feed_Element::$$_element
Details
Type
\DOMElement
Inherited_from
\Zend_Feed_Element::$$_element  
>VPropertyprotectedstring $_encoding = 'UTF-8'
inherited

Character encoding to utilize

Inherited from: \Zend_Feed_Element::$$_encoding
Default value'UTF-8'Details
Type
string
Inherited_from
\Zend_Feed_Element::$$_encoding  
>VPropertyprotectedarray $_entries
Cache of feed entries.
Details
Type
array
>VPropertyprotectedinteger $_entryIndex = 0
Current index on the collection of feed entries for the Iterator implementation.
Default value0Details
Type
integer
>VPropertyprotected\Zend_Feed_Element $_parentElement
inherited
Inherited from: \Zend_Feed_Element::$$_parentElement

Methods

methodpublic__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
NameTypeDescription
$varstring

The element to get the string value of.

$unusedmixed

This parameter is not used.

Returns
TypeDescription
mixedThe 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

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

Parameters
NameTypeDescription
$uristring

The full URI of the feed to load, or NULL if not retrieved via HTTP or as an array.

$stringstring

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
ExceptionDescription
\Zend_Feed_ExceptionIf loading the feed failed.
methodpublic__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
NameTypeDescription
$varstring

The property to access.

Returns
TypeDescription
mixed
methodpublic__isset(string $var) : boolean
inherited

Map isset calls onto the underlying entry representation.

Inherited from: \Zend_Feed_Element::__isset()
Parameters
NameTypeDescription
$varstring
Returns
TypeDescription
boolean
methodpublic__set(string $var, string $val) : void
inherited

Map variable sets onto the underlying entry representation.

Inherited from: \Zend_Feed_Element::__set()
Parameters
NameTypeDescription
$varstring

The property to change.

$valstring

The property's new value.

Throws
ExceptionDescription
\Zend_Feed_Exception
methodpublic__sleep() : array

Prepare for serialiation

Returns
TypeDescription
array
methodpublic__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
TypeDescription
string
methodpublic__unset(string $var) : void
inherited

Remove all children matching $var.

Inherited from: \Zend_Feed_Element::__unset()
Parameters
NameTypeDescription
$varstring
methodpublic__wakeup() : void

Load the feed as an XML DOMDocument object

Throws
ExceptionDescription
\Zend_Feed_Exception
methodprotected_buildEntryCache() : void

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

methodprotected_children(string $var) : array
inherited

Finds children with tagnames matching $var

Inherited from: \Zend_Feed_Element::_children()

Similar to SimpleXML's children() method.

Parameters
NameTypeDescription
$varstring

Tagname to match, can be either namespace:tagName or just tagName.

Returns
TypeDescription
array
methodprotected_importFeedFromString(string $feed) : string

Import a feed from a string

Protects against XXE attack vectors.

Parameters
NameTypeDescription
$feedstring
Returns
TypeDescription
string
Throws
ExceptionDescription
\Zend_Feed_Exceptionon detection of an XXE vector
methodprotected_mapFeedEntries(\DOMElement $root, array $array) : \DOMElement
abstract

Generate the entries of the feed when working in write mode

Parameters
NameTypeDescription
$root\DOMElement

the root node to use

$arrayarray

the data to use

Returns
TypeDescription
\DOMElementroot node
methodprotected_mapFeedHeaders(array $array) : \DOMElement
abstract

Generate the header of the feed when working in write mode

Parameters
NameTypeDescription
$arrayarray

the data to use

Returns
TypeDescription
\DOMElementroot node
methodpubliccount() : integer

Get the number of entries in this feed object.

Returns
TypeDescription
integerEntry count.
methodpubliccurrent() : mixed

Required by the Iterator interface.

Returns
TypeDescription
mixedThe current row, or null if no rows.
methodprotectedensureAppended() : void
inherited

Appends this element to its parent if necessary.

Inherited from: \Zend_Feed_Element::ensureAppended()
methodpublicgetDOM() : \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
TypeDescription
\DOMDocument
methodpublicgetEncoding() : string
inherited

Get encoding

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

Required by the Iterator interface.

Returns
TypeDescription
mixedThe current row number (starts at 0), or NULL if no rows
methodpublicnext() : mixed

Required by the Iterator interface.

Returns
TypeDescription
mixedThe next row, or null if no more rows.
methodpublicoffsetExists(string $offset) : boolean
inherited

Required by the ArrayAccess interface.

Inherited from: \Zend_Feed_Element::offsetExists()
Parameters
NameTypeDescription
$offsetstring
Returns
TypeDescription
boolean
methodpublicoffsetGet(string $offset) : string
inherited

Required by the ArrayAccess interface.

Inherited from: \Zend_Feed_Element::offsetGet()
Parameters
NameTypeDescription
$offsetstring
Returns
TypeDescription
string
methodpublicoffsetSet(string $offset, string $value) : string
inherited

Required by the ArrayAccess interface.

Inherited from: \Zend_Feed_Element::offsetSet()
Parameters
NameTypeDescription
$offsetstring
$valuestring
Returns
TypeDescription
string
methodpublicoffsetUnset(string $offset) : boolean
inherited

Required by the ArrayAccess interface.

Inherited from: \Zend_Feed_Element::offsetUnset()
Parameters
NameTypeDescription
$offsetstring
Returns
TypeDescription
boolean
methodpublicrewind() : void

Required by the Iterator interface.

methodpublicsaveXml() : 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
TypeDescription
string
methodpublicsaveXmlFragment() : 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
TypeDescription
string
methodpublicsend() : void
abstract

Send feed to a http client with the correct header

Throws
ExceptionDescription
\Zend_Feed_Exceptionif headers have already been sent
methodpublicsetDOM(\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
NameTypeDescription
$element\DOMElement
methodpublicsetEncoding(string $value) : \Zend_Feed_Element
inherited

Set encoding

Inherited from: \Zend_Feed_Element::setEncoding()
Parameters
NameTypeDescription
$valuestring

Encoding to use

Returns
TypeDescription
\Zend_Feed_Element
methodpublicsetParent(\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
NameTypeDescription
$element\Zend_Feed_Element
methodpublicvalid() : boolean

Required by the Iterator interface.

Returns
TypeDescription
booleanWhether the iteration is valid
Documentation was generated by phpDocumentor 2.0.0a12.