RSSを取得して表示させるcgiのPHP版 [技術]

追記：非常におおざっぱな更新履歴

2006年8月8日、以下の機能を修正・追加しました。

・表示件数に10を指定しても1件しか表示されない不具合を修正

・要約を表示できる機能を追加（ただし、非常に不安定）

要約表示機能の詳細については、本文をご覧下さい。

以前、hiroさんの作られたcgiをモディファイして公開したやつのPHP版を作ったので公開します。今回は、from scratchで一から自分でコードを書きました。機能的な点から見た主な変更点は、「ATOMにも対応」、「アメブロのフィードを取り損ねる不具合を修正」、といった感じです。

で、設置方法ですが、まずここからzipファイルをDLしてください。DLしたzipファイルを解凍すると、rss.phpとtest.phpという2つのファイルが出来ます。

解凍された2つのファイルのうち、test.phpのほうは直接の挙動にはまったく関係ないんですが、お使いのサーバのPHPにdomxmlモジュールが組み込まれているかをチェックするものなので、まずはこいつをサーバにアップして、パーミッションを644にして呼び出してみてください。サーバにdomxmlが組み込まれている旨の表示が出ればOK。rss.phpの設定に進んでください。サーバにdomxmlが組み込まれていない胸の表示が出た場合は、ごめんなさい、お使いのサーバではrss.phpは動きません。

さて、rss.phpの設定ですが、任意のエディタでファイルを開いてもらって、行頭の「<?php」を除いた最初の4行が設定項目です。以下にその4行を示します。

 $allowed_url="http://www.example.com/";
$new_range=24;
$font_color="red";
$new_string="新着";

まず、$allowed_urlでは呼び出し元のURLを設定します。これは、他のサーバからの呼び出しを防ぐためのものなので、絶対に設定してください。設定しないと動きません。また、以前のヴァージョンでは、呼び出し元のURLが複数指定できたのですが、今回は1つしか指定できません（要望があれば複数指定もできるようにします）。

$new_rangeでは新着表示を何時間以内の投稿記事であれば表示させるようにするかを指定します。デフォルトでは24時間以内の記事であれば新着表示がされるようになっています。

$font_colorでは新着表示の文字列の色を指定します。デフォルトでは赤が指定されています。

$new_stringでは新着表示の文字列を指定します。デフォルトでは「New」が指定されています（ゆえに、$new_range、$font_colorともにデフォルトの場合は、24時間以内の投稿記事には「New」が付加されることになります）。

このように設定を終えたrss.phpをサーバにアップして、パーミッションを644にすれば、ひとまず設置は完了です。あとは、

 <script language="JavaScript" charset="UTF-8" src="..." />

のような記述を、RSS（ATOM）から取得した記事一覧を表示させたい位置にすればいいのですが、ここでの肝は「src="..."」の「...」の部分で、ここは以下のように記述します。

 http://www.example.com/cgi/rss.php?url=...&type=...&num=...

ここで、urlには取得したいRSS（ATOM）のURLを、typeにはRSSかATOMかの指定を（RSSなら「rss」、ATOMなら「atom」を指定します。何も指定しない場合、「rss」がセットされます）、numには表示させたい記事件数を指定します（指定しない場合は1が指定されます）。

2006年8月8日追記：　desc=1の指定で記事の要約を表示できるようにしました。ただ、非常に不安定であるので、とりあえずの暫定機能、という感じです。追って修正版をアップしたい、と思います。

と、まあ、こんな感じなのですが、いかんせんやっつけ仕事であり、その上ろくにテストもしていないので、思わぬところでコケる可能性は否定できません。ので、何かあればここのコメント欄にでもご報告ください。