DIV CSS 佈局教程網

用一個簡單的 PHP 函式打造進階 RSS 聚合器
編輯:AJAX基礎知識     

RSS 聚合器特別適合用標準 Ajax 引擎來建構,但要對 RSS 饋送發出跨域的 Ajax 請求,向來是個難題。本文示範如何用一个简单的 PHP 函式,把 Ajax 引擎與遠端內容「橋接」起來。

一、前言

現在做一個 RSS 聚合器並不難,但做一個高品質的聚合器仍有相當門檻。客製化聚合器的價值在於介面完全由你掌控。RSS 聚合之所以特別適合 Ajax 應用,原因有兩點:它本質上是 XML 格式,而 Ajax 能夠在不換頁的前提下順暢地呈現新內容。

問題也很明確:標準 Ajax 引擎無法發出跨域請求。本文要做的,就是用一個極簡的 PHP 函式把 Ajax 引擎與遠端饋送接起來。

本文假設你已具備基本的 PHP 概念,以及使用 Ajax、解析 XML 的經驗。

二、Ajax 引擎的準備

先介紹一下用來發出請求的引擎。它的作用是簡化 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 物件

這個物件負責接收引擎送來的回應:

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 物件

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 安全討論中反覆出現的問題。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved