Zend_Feed_Writer ist die Bruderkomponente zu Zend_Feed_Reader und verantwortlich für die Erzeugung von Feeds für die Ausgabe. Sie unterstützt die Atom 1.0 Spezifikation (RFC 4287) und RSS 2.0 wie vom RSS Advisory Board (RSS 2.0.11) spezifiziert. Es ist kein Nachkomme dieser Standard. Trotzdem bietet es ein einfaches System der Erweiterung welches es erlaube jede Erweiterung/Modul für jede der zwei Spezifikationen zu implementieren wenn diese nicht von Haus aus angeboten werden. Auf vielen Wegen ist Zend_Feed_Writer das Gegenteil von Zend_Feed_Reader. Wobei Zend_Feed_Reader darauf fokusiert ist ein einfach zu verwendendes Architektur Frontend durch Getter Methoden anzubieten, und Zend_Feed_Writer durch ähnlich benannte Setter oder Mutatoren. Das stellt sicher das die API keine weitere Lernkurve erfordert wenn jemand bereits mit Zend_Feed_Reader bekannt ist. Als Ergebnis dieses Designs, ist der Rest sogar einleuchtend. Dahinter, wird jedes Datenset eines Zend_Feed_Reader Objekts wärend der Darstellungszeit in ein DOMDocument Objekt übersetzt indem die notwendigen Feed Elemente verwendet werden. Für jeden unterstützten Feed Typen gibt es beide, sowohl einen Atom 1.0 als auch einen RSS 2.0 Renderer. Die Verwendung von DOMDocument statt einer Template Lösung hat viele Vorteile. Der offensichtlichste ist die Möglichkeit das DOMDocument zu exportieren um es weiter zu bearbeiten und auf PHP DOM für die Korrakturen und richtige Darstellung zu setzen. Wie bei Zend_Feed_Reader ist Zend_Feed_Writer ein alleinstehender Ersatz für Zend_Feed's Builder Architektur und nicht kompatibel mit diesen Klassen. Die Architektur von Zend_Feed_Writer ist sehr einfach. Es hat zwei Kernsets von Klassen: Container und Renderer. The containers include the Zend_Feed_Writer_Feed and Zend_Feed_Writer_Entry classes. The Entry classes can be attached to any Feed class. The sole purpose of these containers is to collect data about the feed to generate using a simple interface of setter methods. These methods perform some data validity testing. For example, it will validate any passed URIs, dates, etc. These checks are not tied to any of the feed standards. The container objects also contain methods to allow for fast rendering and export of the final feed, and these can be reused at will. While there are two data containers, there are four renderers - two matching container renderers per support feed type. The renderer accept a container, and based on its content attempt to generate a valid feed. If the renderer is unable to generate a valid feed, perhaps due to the container missing an obligatory data point, it will report this by throwing an Exception. While it is possible to ignore Exceptions, this removes the default safeguard of ensuring you have sufficient data set to render a wholly valid feed. Due to the system being divided between data containers and renderers, it can make Extensions somewhat interesting. A typical Extension offering namespaced feed and entry level elements, must itself reflect the exact same architecture, i.e. offer feed and entry level data containers, and matching renderers. There is, fortunately, no complex integration work required since all Extension classes are simply registered and automatically used by the core classes. We'll meet Extensions in more detail at the end of this section. Using Zend_Feed_Reader is as simple as setting data and triggering the renderer. Here is an example to generate a minimal Atom 1.0 feed. setTitle('Paddy\'s Blog'); $feed->setLink('http://www.example.com'); $feed->setFeedLink('http://www.example.com/atom', 'atom'); $feed->addAuthor(array( 'name' => 'Paddy', 'email' => 'paddy@example.com', 'uri' => 'http://www.example.com', )); $feed->setDateModified(time()); $feed->addHub('http://pubsubhubbub.appspot.com/'); /** * Add one or more entries. Note that entries must * be manually added once created. */ $entry = $feed->createEntry(); $entry->setTitle('All Your Base Are Belong To Us'); $entry->setLink('http://www.example.com/all-your-base-are-belong-to-us'); $entry->addAuthor(array( 'name' => 'Paddy', 'email' => 'paddy@example.com', 'uri' => 'http://www.example.com', )); $entry->setDateModified(time()); $entry->setDateCreated(time()); $entry->setDescription('Exposing the difficultly of porting games to English.'); $entry->setContent('I am not writing the article. The example is long enough as is ;).'); $feed->addEntry($entry); /** * Render the resulting feed to Atom 1.0 and assign to $out. * You can substitute "atom" with "rss" to generate an RSS 2.0 feed. */ $out = $feed->export('atom'); ]]> The output rendered should be as follows: <?xml version="1.0" encoding="utf-8"?> <feed xmlns="http://www.w3.org/2005/Atom"> <title type="text">Paddy's Blog</title> <subtitle type="text">Writing about PC Games since 176 BC.</subtitle> <updated>2009-12-14T20:28:18+00:00</updated> <generator uri="http://framework.zend.com" version="1.10.0alpha"> Zend_Feed_Writer </generator> <link rel="alternate" type="text/html" href="http://www.example.com"/> <link rel="self" type="application/atom+xml" href="http://www.example.com/atom"/> <id>http://www.example.com</id> <author> <name>Paddy</name> <email>paddy@example.com</email> <uri>http://www.example.com</uri> </author> <link rel="hub" href="http://pubsubhubbub.appspot.com/"/> <entry> <title type="html"><![CDATA[All Your Base Are Belong To Us]]></title> <summary type="html"> <![CDATA[Exposing the difficultly of porting games to English.]]> </summary> <published>2009-12-14T20:28:18+00:00</published> <updated>2009-12-14T20:28:18+00:00</updated> <link rel="alternate" type="text/html" href="http://www.example.com/all-your-base-are-belong-to-us"/> <id>http://www.example.com/all-your-base-are-belong-to-us</id> <author> <name>Paddy</name> <email>paddy@example.com</email> <uri>http://www.example.com</uri> </author> <content type="html"> <![CDATA[I am not writing the article. The example is long enough as is ;).]]> </content> </entry> </feed> This is a perfectly valid Atom 1.0 example. It should be noted that omitting an obligatory point of data, such as a title, will trigger an Exception when rendering as Atom 1.0. This will differ for RSS 2.0 since a title may be omitted so long as a description is present. This gives rise to Exceptions that differ between the two standards depending on the renderer in use. By design, Zend_Feed_Writer will not render an invalid feed for either standard unless the end-user deliberately elects to ignore all Exceptions. Before you can render a feed, you must first setup the data necessary for the feed being rendered. This utilises a simple setter style API which doubles as an initial method for validating the data being set. By design, the API closely matches that for Zend_Feed_Reader to avoid undue confusion and uncertainty. Zend_Feed_Writer offers this API via its data container classes Zend_Feed_Writer_Feed and Zend_Feed_Writer_Entry. These classes merely store all feed data in type-agnostic manner, meaning you may reuse any data container with any renderer without requiring additional work. Both classes are also amenable to Extensions, meaning that an Extension may define its own container classes which are registered to the base container classes as extensions, and are checked when any method call triggers the base container's __call() method. Here's a summary of the Core API for Feeds. You should note it comprises not only the basic RSS and Atom standards, but also accounts for a number of included Extensions bundled with Zend_Feed_Writer. The naming of these Extension sourced methods remain fairly generic - all Extension methods operate at the same level as the Core API though we do allow you to retrieve any specific Extension object separately if required. setId() Set a unique ID associated with this feed. For Atom 1.0 this is an atom:id element, whereas for RSS 2.0 it is added as a guid element. These are optional so long as a link is added, i.e. the link is set as the ID. setTitle() Set the title of the feed. setDescription() Set the text description of the feed. setLink() Set a URI to the HTML website containing the same or similar information as this feed (i.e. if the feed is from a blog, it should provide the blog's URI where the HTML version of the entries can be read). setFeedLinks() Add a link to an XML feed, whether the feed being generated or an alternate URI pointing to the same feed but in a different format. At a minimum, it is recommended to include a link to the feed being generated so it has an identifiable final URI allowing a client to track its location changes without necessitating constant redirects. The parameter is an array of arrays, where each sub-array contains the keys "type" and "uri". The type should be one of "atom", "rss", or "rdf". If a type is omitted, it defaults to the type used when rendering the feed. setAuthors() Sets the data for authors. The parameter is an array of arrays where each sub-array may contain the keys "name", "email" and "uri". The "uri" value is only applicable for Atom feeds since RSS contains no facility to show it. For RSS 2.0, rendering will create two elements - an author element containing the email reference with the name in brackets, and a Dublin Core creator element only containing the name. setAuthor() Sets the data for a single author following the same format as described above for a single sub-array. setDateCreated() Sets the date on which this feed was created. Generally only applicable to Atom where it represents the date the resource described by an Atom 1.0 document was created. The expected parameter may be a UNIX timestamp or a Zend_Date object. getDateModified() Sets the date on which this feed was last modified. The expected parameter may be a UNIX timestamp or a Zend_Date object. setLanguage() Sets the language of the feed. This will be omitted unless set. getGenerator() Allows the setting of a generator. The parameter should be an array containing the keys "name", "version" and "uri". If omitted a default generator will be added referencing Zend_Feed_Writer, the current Zend Framework version and the Framework's URI. setCopyright() Sets a copyright notice associated with the feed. setHubs() Accepts an array of Pubsubhubbub Hub Endpoints to be rendered in the feed as Atom links so that PuSH Subscribers may subscribe to your feed. Note that you must implement a Pubsubhubbub Publisher in order for real-time updates to be enabled. A Publisher may be implemented using Zend_Feed_Pubsubhubbub_Publisher. setCategories() Accepts an array of categories for rendering, where each element is itself an array whose possible keys include "term", "label" and "scheme". The "term" is a typically a category name suitable for inclusion in a URI. The "label" may be a human readable category name supporting special characters (it is encoded during rendering) and is a required key. The "scheme" (called the domain in RSS) is optional but must be a valid URI. Here's a summary of the Core API for Entries/Items. You should note it comprises not only the basic RSS and Atom standards, but also accounts for a number of included Extensions bundled with Zend_Feed_Writer. The naming of these Extension sourced methods remain fairly generic - all Extension methods operate at the same level as the Core API though we do allow you to retrieve any specific Extension object separately if required. setId() Set a unique ID associated with this feed. For Atom 1.0 this is an atom:id element, whereas for RSS 2.0 it is added as a guid element. These are optional so long as a link is added, i.e. the link is set as the ID. setTitle() Set the title of the feed. setDescription() Set the text description of the feed. setLink() Set a URI to the HTML website containing the same or similar information as this feed (i.e. if the feed is from a blog, it should provide the blog's URI where the HTML version of the entries can be read). setFeedLinks() Add a link to an XML feed, whether the feed being generated or an alternate URI pointing to the same feed but in a different format. At a minimum, it is recommended to include a link to the feed being generated so it has an identifiable final URI allowing a client to track its location changes without necessitating constant redirects. The parameter is an array of arrays, where each sub-array contains the keys "type" and "uri". The type should be one of "atom", "rss", or "rdf". If a type is omitted, it defaults to the type used when rendering the feed. setAuthors() Sets the data for authors. The parameter is an array of arrays where each sub-array may contain the keys "name", "email" and "uri". The "uri" value is only applicable for Atom feeds since RSS contains no facility to show it. For RSS 2.0, rendering will create two elements - an author element containing the email reference with the name in brackets, and a Dublin Core creator element only containing the name. setAuthor() Sets the data for a single author following the same format as described above for a single sub-array. setDateCreated() Sets the date on which this feed was created. Generally only applicable to Atom where it represents the date the resource described by an Atom 1.0 document was created. The expected parameter may be a UNIX timestamp or a Zend_Date object. getDateModified() Sets the date on which this feed was last modified. The expected parameter may be a UNIX timestamp or a Zend_Date object. setLanguage() Sets the language of the feed. This will be omitted unless set. getGenerator() Allows the setting of a generator. The parameter should be an array containing the keys "name", "version" and "uri". If omitted a default generator will be added referencing Zend_Feed_Writer, the current Zend Framework version and the Framework's URI. setCopyright() Sets a copyright notice associated with the feed. setHubs() Accepts an array of Pubsubhubbub Hub Endpoints to be rendered in the feed as Atom links so that PuSH Subscribers may subscribe to your feed. Note that you must implement a Pubsubhubbub Publisher in order for real-time updates to be enabled. A Publisher may be implemented using Zend_Feed_Pubsubhubbub_Publisher. setCategories() Accepts an array of categories for rendering, where each element is itself an array whose possible keys include "term", "label" and "scheme". The "term" is a typically a category name suitable for inclusion in a URI. The "label" may be a human readable category name supporting special characters (it is encoded during rendering) and is a required key. The "scheme" (called the domain in RSS) is optional but must be a valid URI.