RSS 聚合器特別適合用標準 Ajax 引擎來建構,但要對 RSS 饋送發出跨域的 Ajax 請求,向來是個難題。本文示範如何用一个简单的 PHP 函式,把 Ajax 引擎與遠端內容「橋接」起來。
現在做一個 RSS 聚合器並不難,但做一個高品質的聚合器仍有相當門檻。客製化聚合器的價值在於介面完全由你掌控。RSS 聚合之所以特別適合 Ajax 應用,原因有兩點:它本質上是 XML 格式,而 Ajax 能夠在不換頁的前提下順暢地呈現新內容。
問題也很明確:標準 Ajax 引擎無法發出跨域請求。本文要做的,就是用一個極簡的 PHP 函式把 Ajax 引擎與遠端饋送接起來。
本文假設你已具備基本的 PHP 概念,以及使用 Ajax、解析 XML 的經驗。
先介紹一下用來發出請求的引擎。它的作用是簡化 Ajax 呼叫、消除大量發送請求與調度回應時的冗餘。這裡不討論它的內部程式碼,只說明怎麼用。
首先在 index.html 中引入組成引擎的 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:
<html>
<head>
<title>RSS Aggregation with PHP and Ajax</title>
<link href="css/layout.css" rel="stylesheet" type="text/css" />
<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>
<script type="text/javascript" src="js/controller/Aggregator.js"></script>
<script type="text/javascript" src="js/view/Feed.js"></script>
</head>
<body>
<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>
</body>
</html>
這個檔案負責載入 CSS 與所有 JavaScript,並定義版面用的 DIV 容器。表單裡有一個輸入框供使用者貼上 RSS 網址,按下送出後便向該位址請求,並把回應交給名為 Aggregator 的物件處理。
跨域 Ajax 請求在瀏覽器端是不可能的,但可以藉助伺服器端語言繞道。做法出乎意料地簡單。
PHP 提供 file_get_contents,能把整個檔案內容讀進一個字串。只要啟用 fopen 包裝器(PHP 安裝時預設開啟,除非 php.ini 中把 allow_url_fopen 設為 off),這個「檔案」就可以是遠端網址。
於是 bridge/rss.php 的全部內容就是:
<?
header("Content-Type: application/xml; charset=UTF-8");
echo file_get_contents($_GET['feed']);
?>
第一行設定回應的內容型別為 XML,讓前端的請求物件能正確解析;接著把使用者提供的饋送網址丟給 file_get_contents,讀到的內容原封不動 echo 出去。瀏覽器眼中這只是一個同域的請求,跨域限制自然不復存在。
這個物件負責接收引擎送來的回應:
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);
}
}
回呼發生時,先用 Ajax.checkReadyState() 確認請求狀態(並傳入一個用來顯示「載入中」訊息的 DIV id)。接著解析出饋送的標題、連結與所有 item,據此建立一個新的 Feed 物件,塞進 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 />";
}
}
displayFeedTitles() 顯示饋送標題後,呼叫 DisplayTitles();後者依 id 取回該饋送的所有項目標題,為它們建立一個新的 DIV 並掛在標題之後。這個「摺疊區」的設計讓使用者能點標題來收合或展開項目清單:
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 類別。建構時接收 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);
var _link = items[i].getElementsByTagName("link")[0].firstChild.nodeValue;
this.linkArray.push(_link);
var description = items[i].getElementsByTagName("description")[0].firstChild.nodeValue;
this.descriptionArray.push(description);
var pubDate = items[i].getElementsByTagName("pubDate")[0].firstChild.nodeValue;
this.pubDateArray.push(pubDate);
}
}
所有值都存進平行陣列之後,顯示資料就只是取值與組字串的問題:
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() 產生可點擊收合的標題,GetAllTitles() 回傳全部項目標題,GetDetails() 則依 id 組出該項目的完整細節 HTML。
到這裡,聚合器已能運作。下一步自然的延伸是加一個計時器,週期性檢查已加入的饋送是否有更新;再進一步,可以將饋送清單存進資料庫,依使用者帳號分別提供。因篇幅所限,這些就留給你實作。
值得特別一提的是,bridge/rss.php 直接將使用者輸入的網址交給 file_get_contents,這在正式環境中是危險的。若不檢查協定與主機白名單,攻擊者就能把它當成跳板去存取內網位址(SSRF)。上線前至少該做三件事:限定 http/https 協定、對目標主機設白名單、並為回應加上大小與逾時限制。
另外,回傳的 RSS 內容若直接以 innerHTML 插入頁面,饋送中的惡意標籤就會成為 XSS 的入口——這正是後續 Web 2.0 安全討論中反覆出現的問題。