Einführung

Feeds importieren

Zend_Feed ermöglicht es Entwicklern, Feeds sehr einfach abzurufen. Wenn Du die URI eines Feeds kennst, verwende einfach die Zend_Feed::import() Methode:

  1. span style="color: #ff0000;">'http://feeds.example.com/feedName');

Du kannst Zend_Feed außerdem verwenden, um Inhalte eines Feeds aus einer Datei oder die Inhalte aus einem PHP String Variable zu abzurufen.

  1. // Feeds von einer Textdatei importieren
  2. 'feed.xml');
  3.  
  4. // Feeds von einer PHP String Variable importieren

In jedem der obigen Beispiele wird bei Erfolg abhängig vom Typ des Feeds ein Objekt einer Klasse zurück gegeben, welche Zend_Feed_Abstract erweitert. Wird ein RSS Feed durch eine der obigen Importiermethoden abgerufen, wird eine Zend_Feed_Rss Objekt zurückgegeben. Auf der anderen Seite wird beim Importieren eines Atom Feeds ein Zend_Feed_Atom Objekt zurückgegeben. Bei Fehlern, wie z.B. ein unlesbarer oder nicht wohlgeformter Feed, werfen die Importiermethoden auch ein Zend_Feed_Exception Objekt.

Eigene Feeds

Zend_Feed ermöglicht es Entwicklern Ihre eigenen Feeds sehr einfach zu erstellen. Man muß nur ein Array erstellen und es in Zend_Feed importieren, Dieses Array kann mit Zend_Feed::importArray() oder mit Zend_Feed::importBuilder() importiert werden. Im letzteren Fall wird das Array on the Fly durch eine eigene Datenquelle berechnet die Zend_Feed_Builder_Interface implementiert.

Importieren eines eigenen Arrays

  1. // Importieren eines Feeds von einem Array
  2. // Die folgende Zeile ist identisch mit der obigen; standardmäßig
  3. // wird eine Zend_Feed_Atom Instanz zurückgegeben
  4. 'atom');
  5.  
  6. // Importieren eines RSS Feeds von einem Array
  7. 'rss');

Das Format des Arrays muß dieser Struktur entsprechen:

  1. span style="color: #808080; font-style: italic;">// benötigt
  2.     'title' => 'Titel des Feeds',
  3.     'link'  => 'Kanonische URL zu dem Feed',
  4.  
  5.     // optional
  6.     'lastUpdate' => 'Zeitstempel des Update Datums',
  7.     'published'  => 'Zeitstempel des Veröffentlichungs Datums',
  8.  
  9.     // benötigt
  10.     'charset' => 'Zeichensatz der textuellen Daten',
  11.  
  12.     //optional
  13.     'description' => 'Kurzbeschreibung des Feeds',
  14.     'author'      => 'Author, Veröffentlicher des Feeds',
  15.     'email'       => 'Email des Authors',
  16.  
  17.     // optional, ignoriert wenn Atom verwendet wird
  18.     'webmaster' => 'Email Adresse der Person die für technische '
  19.                 .  'Belange verantwortlich ist',
  20.  
  21.     //optional
  22.     'copyright' => 'Copyright Notiz',
  23.     'image'     => 'URL zu Bildern',
  24.     'generator' => 'Ersteller',
  25.     'language'  => 'Sprache in welcher der Feed geschrieben ist',
  26.  
  27.     // optional, ignoriert wenn Atom verwendet wird
  28.     'ttl'    => 'Wie lange ein Feed gecached werden kann '
  29.              .  'bevor er erneut werden muß',
  30.     'rating' => 'Die PICS Rate dieses Kanals',
  31.  
  32.     // optional, ignoriert wenn Atom verwendet wird
  33.     // eine Wolke die über Updates benachrichtigt wird
  34.     'cloud'// benötigt
  35.         'domain' => 'Domain der Wolke, e.g. rpc.sys.com',
  36.  
  37.         // optional, Standard ist 80
  38.         'port' => 'Port zu dem verbunden wird',
  39.  
  40.         // benötigt
  41.         'path'              => 'Pfad der Wolke, e.g. /RPC2',
  42.         'registerProcedure' => 'Prozedur die aufgerufen wird, '
  43.                             .  'z.B. myCloud.rssPleaseNotify'
  44.         'protocol'          => 'Protokoll das verwendet wird, z.B. '
  45.                             .  'soap oder xml-rpc'
  46.     ),
  47.  
  48.     // optional, ignoriert wenn Atom verwendet wird
  49.     // Eine Texteingabebox die im Feed angezeigt werden kann
  50.     'textInput'// benötigt
  51.         'title'       => 'Die Überschrift des Senden Buttons im '
  52.                       .  'Texteingabefeld',
  53.         'description' => 'Beschreibt das Texteingabefeld',
  54.         'name'        => 'Der Name des Text Objekts im '
  55.                       .  'Texteingabefeld',
  56.         'link'        => 'Die URL des CGI Skripts das Texteingabe '
  57.                       .  'Anfragen bearbeitet'
  58.     ),
  59.  
  60.     // optional, ignoriert wenn Atom verwendet wird
  61.     // Hinweise geben welche Stunden übersprungen werden können
  62.     'skipHours'// bis zu 24 Zeilen dessen Werte eine Nummer zwischen 0 und 23 ist
  63.         // z.B. 13 (1pm)
  64.         'hour in 24 format'
  65.     ),
  66.  
  67.     // optional, ignoriert wenn Atom verwendet wird
  68.     // Hinweise geben welche Tage übersprungen werden können
  69.     'skipDays '// bis zu 7 Zeilen dessen Werte Montag, Dienstag, Mittwoch,
  70.         // Donnerstag, Freitag, Samstag oder Sonntag sind
  71.         // z.B. Montag
  72.         'a day to skip'
  73.     ),
  74.  
  75.     // optional, ignoriert wenn Atom verwendet wird
  76.     // Itunes Erweiterungsdaten
  77.     'itunes'// optional, Standard ist der Wert der author Spalte
  78.         'author' => 'Musiker Spalte',
  79.  
  80.         // optional, Standard ist der Wert der author Spalte
  81.         // Eigentümer des Podcasts
  82.         'owner''name'  => 'Name des Eigentümers',
  83.             'email' => 'Email des Eigentümers'
  84.         ),
  85.  
  86.         // optional, Standard ist der image Wert
  87.         'image' => 'Album/Podcast Bild',
  88.  
  89.         // optional, Standard ist der description Wert
  90.         'subtitle' => 'Kurzbeschreibung',
  91.         'summary'  => 'Langbeschreibung',
  92.  
  93.         // optional
  94.         'block' => 'Verhindern das eine Episode erscheint (ja|nein)',
  95.  
  96.         // benötigt
  97.         // 'Kategoriespalte und iTunes Music Store Browse'
  98.         'category'// bis zu 3 Zeilen
  99. // benötigt
  100.                 'main' => 'Hauptkategorie',
  101.  
  102.                 // optional
  103.                 'sub'  => 'Unterkategorie'
  104.             ),
  105.         ),
  106.  
  107.         // optional
  108.         'explicit'     => 'Elterliche Anweisungsspalte (ja|nein|löschen)',
  109.         'keywords'     => 'Eine kommagetrennte Liste von maximal '
  110.                        .  '12 Schlüsselwörtern',
  111.         'new-feed-url' => 'Verwendet um iTunes über eine neue URL '
  112.                        .  'Lokation zu informieren'
  113.     ),
  114.  
  115.     'entries'// benötigt
  116.             'title' => 'Titel des Feedeintrags',
  117.             'link'  => 'URL zum Feedeintrag',
  118.  
  119.             // benötigt, nur Text, kein HTML
  120.             'description'  => 'Kurzversion des Feedeintrags',
  121.  
  122.             //optional
  123.             'guid' => 'Id des Artikels, wenn nicht angegeben '
  124.                    .  'wird der link Wert verwendet',
  125.  
  126.             // optional, kann HTML enthalten
  127.             'content' => 'Langversion',
  128.  
  129.             // optional
  130.             'lastUpdate' => 'Zeitstempel des Veröffnetlichungsdatums',
  131.             'comments'   => 'Kommentarseite des Feedeintrags',
  132.             'commentRss' => 'Die FeedURL der zugehörenden Kommentare',
  133.  
  134.             // optional, Originale Quelle des Feedeintrags
  135.             'source'// benötigt
  136.                 'title' => 'Titel der Originalen Quelle',
  137.                 'url'   => 'URL der originalen Quelle'
  138.             ),
  139.  
  140.             // optional, Liste der zugeordneten Kategorien
  141.             'category'// benötigt
  142.                     'term' => 'Überschrift der ersten Kategorie',
  143.  
  144.                     // optional
  145.                     'scheme' => 'URL die das Kategorisierungsschema '
  146.                              .  'identifiziert'//Daten der zweiten Kategorie und so weiter
  147.                 )
  148.             ),
  149.  
  150.             // optional, Liste der Anhänge des Feedeintrags
  151.             'enclosure'// benötigt
  152.                     'url' => 'URL des verlinkten Anhangs',
  153.  
  154.                     // optional
  155.                     'type'   => 'Mime Typ des Anhangs',
  156.                     'length' => 'Länge des verlinkten Inhalts oktal'// Daten für den zweiten Anhang und so weiter
  157. // Daten für den zweiten Eintrag und so weiter
  158.         )
  159.     )
  160. );

Referenzen:

Importieren einer eigenen Daten Quelle

Eine Zend_Feed Instanz kann von jeder Datenquelle erstellt werden die Zend_Feed_Builder_Interface implementiert. Die getHeader() und getEntries() Methoden müssen implementiert werden damit das Objekt mit Zend_Feed::importBuilder() verwendet werden kann. Als einfache Referenz Implementation kann Zend_Feed_Builder verwendet werden, welches ein Array im Contructor entgegen nimmt, einige einfache Prüfungen durchführt, und anschließend in der importBuilder() Methode verwendet werden kann. Die getHeader() Methode muß eine Instanz von Zend_Feed_Builder_Header zurückgeben, und getEntries() muß ein Array von Zend_Feed_Builder_Entry Instanzen zurückgeben.

Note: Zend_Feed_Builder arbeitet als konkrete Implementation um die Verwendung zu demonstrieren. Benutzer sind angehlaten Ihre eigenen Klassen zu Erstellen um Zend_Feed_Builder_Interface zu implementieren.

Hier ist ein Beispiel der Verwendung von Zend_Feed::importBuilder():

  1. // Einen Feed von einer eigenen Erstellungsquelle importieren
  2. // Die folgende Zeile ist mit der obigen äquivalent; standardmäßig
  3. // wird eine Zend_Feed_Atom Instanz zurückgegeben
  4. 'atom');
  5.  
  6. // Einen RSS Feeed von einem Array von eigenen Erstellungsquellen importieren
  7. 'rss');

Ausgeben des Inhalts eines Feeds

Um den Inhalt einer Zend_Feed_Abstract Instanz auszugeben können die send() oder saveXml() Methoden verwendet werden.

  1. span style="color: #808080; font-style: italic;">// Den Feed an der Standardausgabe ausgeben
  2. // HTTP Header und den Feed ausgeben

Einführung