RSS 聚合器特別適合用標準 AJAX 引擎來建構——資料本身就是 XML,而 AJAX 能在不刷新頁面的情況下呈現新內容。真正的障礙只有一個:瀏覽器的同源政策讓跨網域的 AJAX 請求無法直接完成。本文示範如何用一个极简的 PHP 函式,把 AJAX 引擎與遠端 RSS 內容接起來。
做一個能跑的聚合器不難,做一個好用的聚合器卻不容易。本文假定你已具備 PHP 基礎,並有使用 AJAX 與解析 XML 的經驗。
先載入構成引擎的三支 JavaScript 檔:
<script type="text/javascript" src="js/model/HTTP.js"></script> <script type="text/javascript" src="js/model/Ajax.js"></script> <script type="text/javascript" src="js/model/AjaxUpdater.js"></script>
之後只要一行就能發出請求:
AjaxUpdater.Update('GET', 'url', callbackMethod);
AjaxUpdater 負責處理所有 AJAX 呼叫。呼叫它的 Update 方法並傳入請求方式、請求的 URL,以及要把回應轉交給的回呼函式,其餘細節都被封裝起來。
入口是 index.html,它負責載入 CSS、引擎 JavaScript,以及聚合器的控制器與檢視層:
<script type="text/javascript" src="js/controller/Aggregator.js"></script> <script type="text/javascript" src="js/view/Feed.js"></script>
頁面結構如下:
<div id="aggregator">
<form name="feedForm" method="post"
action="javascript:AjaxUpdater.Update('GET',
'bridge/rss.php?feed=' + document.feedForm.feed.value, Aggregator.Read);">
<div class="header">
<input type="text" name="feed" id="feed" size="50">
<input type="submit" name="submit" value="Add Feed">
</div>
</form>
<div class="leftColumn">
<div id="titles"></div>
<div id="loading"></div>
</div>
<div class="rightColumn">
<div id="description"></div>
</div>
</div>
使用者輸入 RSS 網址並送出後,請求會打到 bridge/rss.php,回應則交由 Aggregator 物件的 Read 方法處理。左欄顯示各 feed 的標題與項目清單,右欄顯示被點選項目的內容。
跨網域的 AJAX 請求在瀏覽器端是做不到的,但可以用伺服器端語言繞道。做法出乎意料地簡單——PHP 有一個 file_get_contents,能把整個檔案內容讀進字串;只要開啟 fopen 包裝器(PHP 預設開啟,除非 php.ini 中把 allow_url_fopen 設為 Off),這個「檔案」就可以是遠端網址。
bridge/rss.php 的全部內容:
<?php
header("Content-Type: application/xml; charset=UTF-8");
echo file_get_contents($_GET['feed']);
?>
第一行把回應的內容型別設為有效的 XML,瀏覽器端的 request 物件才能正確處理;接著把使用者傳來的 feed 網址讀出並回吐。就這樣,瀏覽器以為自己在跟同源網站說話,實際資料卻來自遠端。
安全提醒:這個橋接器等於把一個任意 URL 抓取器開放給全世界,會被拿來當跳板探測你的內網或做 SSRF 攻擊。上線前至少要驗證網址的 scheme 僅允許 http/https、比對白名單網域,並設定抓取逾時與回應大小上限。
這個物件負責接收引擎轉來的回應:
Aggregator = new Object();
Aggregator.feedCollection = new Array();
Aggregator.Read = function() {
if (Ajax.checkReadyState('loading') == "OK") {
var title = Ajax.getResponse().getElementsByTagName('title')[0].firstChild.data;
var _link = Ajax.getResponse().getElementsByTagName('link')[0].firstChild.data;
var items = Ajax.getResponse().getElementsByTagName('item');
var feed = new Feed(Aggregator.feedCollection.length, title, _link, items);
Aggregator.feedCollection.push(feed);
Aggregator.displayFeedTitles(feed);
}
}
Read 先解析 feed 的標題、連結與項目,據此建立一個新的 Feed 物件(以集合長度作為 ID),推進 feedCollection,再交給 displayFeedTitles 呈現:
Aggregator.displayFeedTitles = function(feed) {
document.getElementById('titles').innerHTML += feed.GetTitle();
Aggregator.DisplayTitles(feed.id);
}
Aggregator.DisplayTitles = function(id) {
var titleArray = Aggregator.feedCollection[id].GetAllTitles();
var titles = document.createElement("div");
titles.id = "subTitle_" + id;
document.getElementById('title_' + id).appendChild(titles);
for (var i = 0; i < titleArray.length; i++) {
titles.innerHTML += titleArray[i] + "<br />";
}
}
DisplayTitles 依 feed ID 取回集合中的物件,取得所有項目標題,為它們建立一個新的 DIV 掛在該 feed 標題之後。這個巢狀結構讓我們可以點擊 feed 標題來收合或展開底下的項目清單。
另兩個方法負責切換與顯示內容:
Aggregator.ToggleTitles = function(id) {
var titles = document.getElementById('subTitle_' + id);
titles.style.display = (titles.style.display == '') ? 'none' : '';
}
Aggregator.DisplayFeed = function(feedId, id) {
var details = Aggregator.feedCollection[feedId].GetDetails(id);
document.getElementById('description').innerHTML = details;
}
Feed 是一個 prototype 類別,建構子接收 feed 的 ID、標題、連結與項目,設定預設值、建立待用的陣列,再把項目交給 parseItems 逐一解析:
Feed.prototype.parseItems = function(items) {
for (var i = 0; i < items.length; i++) {
var linkTitle = items[i].getElementsByTagName("title")[0].firstChild.nodeValue;
var title = "<a href='#' class='title' onclick='Aggregator.DisplayFeed("
+ this.id + ", " + i + ");'>" + linkTitle + "</a>";
this.titleArray.push(title);
this.linkTitleArray.push(linkTitle);
this.linkArray.push(items[i].getElementsByTagName("link")[0].firstChild.nodeValue);
this.descriptionArray.push(
items[i].getElementsByTagName("description")[0].firstChild.nodeValue);
this.pubDateArray.push(
items[i].getElementsByTagName("pubDate")[0].firstChild.nodeValue);
}
}
值都存進陣列後,何時要顯示都能取用。對外提供三個方法:
Feed.prototype.GetTitle = function() {
return "<div id='title_" + this.id + "'><br/><a href='#'
onclick='Aggregator.ToggleTitles(" + this.id + ");'>" + this.title + "</a></div>";
}
Feed.prototype.GetAllTitles = function() { return this.titleArray; }
Feed.prototype.GetDetails = function(id) {
var details = "<a href='" + this.linkArray[id] + "' target='_blank'>"
+ this.linkTitleArray[id] + "</a><br/>";
details += this.descriptionArray[id] + "<br/>";
details += this.pubDateArray[id];
return details;
}
GetTitle 產生可收合的 feed 標題連結,GetAllTitles 回傳全部項目標題,GetDetails 依 ID 取出該項目的連結、摘要與時間,組成人 HTML 字串回給呼叫者。
目前這個聚合器需要使用者手動按「Add Feed」才會抓一次。下一步自然的延伸是加一個計時器,週期性地重新抓取已加入的 feed,並在內容有變動時更新畫面;再進一步,可以將 feed 清單與已讀狀態存進資料庫,依使用者帳號分別保存。
不過在動手之前,請先處理三個現實問題:一是安全性,前述的 bridge 必須加上網域白名單;二是快取,同一個 feed 在短時間內被重複抓取只會拖慢自己,適度設定 Cache-Control 與伺服器端快取是基本的禮貌;三是解析的健壯性,現行程式每個節點都用 [0].firstChild.nodeValue 直接取值,遇到空標籤或畸形 XML 就會丟出錯誤,正式環境應逐層判空或改用 RSS 解析函式庫。這三點補齊,剩下的功能擴充就只是工時問題了。