documentation/manual/pl/module_specs/Zend_Feed-Introduction.xml

   1 <sect1 id="zend.feed.introduction">
   2     <title>Wprowadzenie</title>
   3     <para>
   4         <code>Zend_Feed</code> zapewnia funkcjonalność umożliwiającą przetwarzanie
   5         kanałów informacyjnych RSS oraz Atom. Zapewnia ona naturalną składnię umożliwiającą
   6         dostęp do elementów kanałów informacyjnych, ich atrybutów oraz atrybutów samych wpisów.
   7         <code>Zend_Feed</code> daje także obszerne wsparcie w modyfikowaniu kanałów
   8         i struktury wpisów w ten sam naturalny sposób i umożliwia zapisanie rezultatów
   9         jako XML. W przyszłości klasa ma zapewnić obsługę protokołu publikowania Atom
  10         (Atom Publishing Protocol).
  11     </para>
  12
  13     <para>
  14         Programowo <code>Zend_Feed</code> składa się z bazowej klasy <code>Zend_Feed</code>,
  15         abstrakcyjnych klas <code>Zend_Feed_Abstract</code> oraz <code>Zend_Feed_Entry_Abstract</code>
  16         reprezentujących kanały informacyjne i ich wpisy, specyficznych implementacji
  17         kanałów i wpisów dla RSS i Atom, oraz z pomocników odpowiedzialnych za
  18         naturalną składnię.
  19     </para>
  20
  21     <para>
  22         W przykładzie poniżej pokazujemy prosty przykład odbierania danych RSS
  23         i zapisywania potrzebnych części danych kanału do prostej tablicy PHP,
  24         która może być potem użyta do wyświetlenia danych, zapisania ich do bazy
  25         danych itp.
  26     </para>
  27
  28     <note>
  29         <title>Bądż ostrożny</title>
  30         <para>
  31             Wiele kanałów RSS ma dostępne różne właściwości samego kanału i jego elementów.
  32             Specyfikacja RSS umożliwia użycie wielu opcjonalnych parametrów, więc
  33             bądź ostrożny gdy będziesz pisał kod pracujący z RSS.
  34         </para>
  35     </note>
  36
  37     <example id="zend.feed.introduction.example.rss">
  38         <title>Użycie Zend_Feed do pobierania danych RSS</title>
  39         <programlisting role="php"><![CDATA[
  40 // Ściągamy najnowsze nagłówki ze Slashdot
  41 try {
  42     $slashdotRss =
  43         Zend_Feed::import('http://rss.slashdot.org/Slashdot/slashdot');
  44 } catch (Zend_Feed_Exception $e) {
  45     // importowanie danych nie udało się
  46     echo "Exception caught importing feed: {$e->getMessage()}\n";
  47     exit;
  48 }
  49
  50 // inicjalizacja tablicy z danymi kanału
  51 $channel = array(
  52     'title'       => $slashdotRss->title(),
  53     'link'        => $slashdotRss->link(),
  54     'description' => $slashdotRss->description(),
  55     'items'       => array()
  56     );
  57
  58 // Pętla po każdym elemencie kanału i zapisanie potrzebnych danych
  59 foreach ($slashdotRss as $item) {
  60     $channel['items'][] = array(
  61         'title'       => $item->title(),
  62         'link'        => $item->link(),
  63         'description' => $item->description()
  64         );
  65 }
  66 ]]>
  67         </programlisting>
  68     </example>
  69 </sect1>