documentation/manual/ja/module_specs/Zend_Feed-ModifyingFeed.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- Reviewed: no -->
   3 <!-- EN-Revision: 21586 -->
   4 <sect1 id="zend.feed.modifying-feed">
   5     <title>フィードおよびエントリの構造の変更</title>
   6
   7     <para>
   8         フィードやエントリを読み込むだけでなく、それらを作成したり変更したりする場合にも
   9         <classname>Zend_Feed</classname> の自然な構文が使用できます。
  10         作成したり変更したりしたオブジェクトを、
  11         妥当な形式の <acronym>XML</acronym> でファイルに保存したりサーバに送信したりといったことが簡単にできます。
  12     </para>
  13
  14     <example id="zend.feed.modifying-feed.example.modifying">
  15         <title>既存のフィードエントリの変更</title>
  16
  17         <programlisting language="php"><![CDATA[
  18 $feed = new Zend_Feed_Atom('http://atom.example.com/feed/1');
  19 $entry = $feed->current();
  20
  21 $entry->title = '新しいタイトルです';
  22 $entry->author->email = 'my_email@example.com';
  23
  24 echo $entry->saveXML();
  25 ]]></programlisting>
  26         <para>
  27             これは、必要な <acronym>XML</acronym> 名前空間も含めた完全な
  28             (最初の <command>&lt;?xml ... &gt;</command> も含めた)
  29             <acronym>XML</acronym> 表記で新しいエントリを出力します。
  30         </para>
  31
  32         <para>
  33             既存のエントリが author タグを保持していない場合にも、
  34             上の例は正しく動作することに注意しましょう。
  35             代入する場所を指定するために、いくらでも <command>-&gt;</command>
  36             をつなげることができます。その途中の段階の要素は、
  37             必要に応じて自動的に作成されます。
  38         </para>
  39     </example>
  40
  41     <para>
  42         <command>atom:</command>、<command>rss:</command>、<command>osrss:</command>
  43         以外の名前空間をエントリで使用したい場合は、<methodname>Zend_Feed::registerNamespace()</methodname>
  44         を使用して <classname>Zend_Feed</classname> で名前空間を登録する必要があります。
  45         既存の要素を書き換えた場合は、常にもとの名前空間が維持されます。
  46         新しい要素を追加する場合には、
  47         明示的に名前空間を指定しない限りデフォルトの名前空間に配置されます。
  48     </para>
  49
  50     <example id="zend.feed.modifying-feed.example.creating">
  51         <title>独自の名前空間の要素としての Atom エントリの作成</title>
  52
  53         <programlisting language="php"><![CDATA[
  54 $entry = new Zend_Feed_Entry_Atom();
  55 // Atom では id は常にサーバから割り当てられます
  56 $entry->title = 'カスタムエントリ';
  57 $entry->author->name = '著者名';
  58 $entry->author->email = 'me@example.com';
  59
  60 // 独自の部分です
  61 Zend_Feed::registerNamespace('myns', 'http://www.example.com/myns/1.0');
  62
  63 $entry->{'myns:myelement_one'} = 'はじめての独自の値';
  64 $entry->{'myns:container_elt'}->part1 = '入れ子になった独自部分、その1';
  65 $entry->{'myns:container_elt'}->part2 = '入れ子になった独自部分、その2';
  66
  67 echo $entry->saveXML();
  68 ]]></programlisting>
  69     </example>
  70 </sect1>
  71 <!--
  72 vim:se ts=4 sw=4 et:
  73 -->