石頭閒語

Photo163 相冊下載工具 (photo163v2.php)。 PHP + JavaScript 實作版本。

發佈: 2006-09-04 最近更新: 2006-09-15 。修正 bug ，一個相冊中的相片，可能放在不同的 server 上，故修改 JavaScript 部份的程式，改從 gPhotosInfo[i][0] 取得 server 代號。

此工具係改良自「Photo163相冊圖檔網址計算器」。第一版的功能只是計算出圖檔網址，現在則具備下載功能。當初原本是打算要實作 JavaScript (AJAX) 版本，但 AJAX 基於安全性考量，不允許 XmlHttpRequest 讀取外部網址的資料，因此我乾脆改寫第一版的程式碼，利用 curl functions 設計一個 XmlHttpRequest 的 proxy ，解決了 XmlHttpRequest 讀取外部網址資料的限制。更進一步地，透過 curl functions 下載圖檔，而且利用 AJAX 的非同步性，實現多線程 (multi-threads) 下載工作的功能。

在 PHP 方面，需要載入 curl extension 。並請修改 php.ini ，將 max_execution_time 設為 600 (秒) 或以上。因為預設的執行時間太短，在網路塞車時， curl 將無法在限定時間內完成圖檔下載動作。在 JavaScript 方面，需要安裝 Yahoo UI Library (See also: ECMAScript/JavaScript toolkit)。這只是一個很簡單的小工具，程式碼集中在一個檔案中 (photo163v2.php) ，由於程式碼包含了 PHP 和 JavaScript ，為了方便說明，在本文中拆成不同區塊，請自行複製貼在一起。

對我來說，這個工具非常實用，而且很簡單，前後只花了我大約 6 小時的時間就完成了全部的實作工作，包括測試及再修改。但是，我想很少人會像我這樣在自己的 Windows 2k/xp 桌面環境電腦安裝 Apache 和 PHP ，所以對其他人來說，或許這個工具的示範意義大於實用性。

Part 1: PHP 以 curl 實作 proxy 及下載功能

此處列出如何利用 curl functions 擷取其他網址的資料。打個比方來說， curl 就像是 JavaScript 中的 XmlHttpRequest 。 PHP 可以利用 curl 讀取網路上的資料，也可以送出資料給網頁 Form 。 curl 隱藏了許多 HTTP protocol 的實作細節 (包括資料傳送編碼、 cookie 、 SSL 等等) ，使得 programmer 可以用擬似瀏覽器的形式，存取網頁內容。注意，我是在防火牆內運行這個工具，不可以將此工具放在公開網域上，否則此工具的 proxy 功能會成為 hacker 的跳板。

Part 2: HTML Form

此處列出 HTML 的部份，主要是使用者輸入資料的表單介面。

Part 3: PHP photo163 data parser

此處列出 PHP 解析自 Photo163 取回的相冊資料的程式碼。並請留意第123-124行、第140行及第145-149行。我習慣上將這視為一種行程間通訊 (IPC) 方法，概念是由 server-side 的 PHP 將要交代 client-side 的 JavaScript 執行的工作資料，以 JavaScript 的語法 (如 JSON ) 輸出在頁面中，亦即 serializing 於頁面。當瀏覽器讀取頁面時，即可喚起與調用。

Part 4: AJAX 多線程下載工作管理者

此處列出 JavaScript 管理非同步性下載工作的程式碼。 JavaScript 雖可取回圖檔，但受到安全性限制而無法儲存。因此此處只是由 JavaScript 透過 XmlHttpRequest 發出下載需求，喚起 server-side 的 PHP proxy ，由 proxy 取得資料並儲取之。由於 XmlHttpRequest 可以同一時間喚起多個工作進行非同步作業，因此需要規劃工作管理程序。此處將工作推入名為 pool 的陣列中，利用這個陣列管理工作。由於是在非同步模式下，所以只能用 push, pop methods 而不可以索引子存取陣列。