DIV CSS 佈局教程網

PHP + Ajax 實作帶進度條的大資料量佇列匯出
編輯:AJAX基礎知識     

要匯出幾萬筆資料成 CSV,若用一個請求一次做完,使用者只能盯著轉圈圈等好幾分鐘,萬一逾時就前功盡棄。比較好的做法是把工作切成小批,用佇列逐批處理,並即時回報進度。

點擊「導出」後:

先統計總筆數:

統計完成後:

點擊確定開始匯出:

整體流程

點擊「確定」呼叫 exportCsv():先清掉等待動畫,彈出統計中對話框,用 Ajax 請求總筆數;若為 0 則提示無法匯出,否則關閉統計框、記錄各類型表格的筆數,接著彈出確認框。

function exportCsv() {
    $('#loading').html('');
    tip();   // 彈出統計總數對話框

    $.post("<?php echo WEB_URL;?>/index.php?q=onlinesea/getwherecount" + search_uri,
        function (json) {
            var return_arr = JSON.parse(json);
            var num = return_arr['total'];
            var processnum = return_arr['processnum'];

            if (num == 0) {
                poptip.title('系統消息');
                poptip.content('查詢結果為空,不能進行數據導出');
            } else {
                poptip.close();

                for (var i in return_arr['cntarr']) {
                    if (return_arr['cntarr'][i] != 0) {
                        count_arr[i] = return_arr['cntarr'][i];
                    }
                }
                var ii = 0;
                for (var i in count_arr) {
                    type_arr[ii] = i;
                    ii++;
                }
                exportCsvConfirm(num, processnum);
            }
        });
}

// 彈出確認下載
function exportCsvConfirm(num, processnum) {
    var msg = '需要導出的數據有 <span style="color: red">' + num
            + '</span> 行,可能會佔用您較多時間。

關鍵:全域狀態與佇列控制

var search_uri = "<?php echo $uri;?>";
var event = "<?php echo $event;?>";
var processed_count = 0;   // 已處理的資料筆數
var index = 1;
var iii = 0;
var ajaxmark = 1;
var win = $.dialog.parent;   // 頂層頁面 window 物件
var count_arr = new Array(<?php echo count($this->tables);?>);
var type_arr = new Array();

這裡的三個變數各司其職:index 用於同一個表資料太多時分批匯出;iii 控制佇列在 type_arr 上的循環位置;ajaxmark 則用來判斷前一個請求是否已完成,完成的話才允許啟動下一個。

function excel_export2(num, processnum) {
    var tabletype = type_arr[iii];
    num = count_arr[tabletype];

    // 佇列已走完
    if (typeof (tabletype) == 'undefined' && typeof (num) == 'undefined') {
        return false;
    }

    // 只有上一個請求結束才啟動下一批
    if (ajaxmark == 1) {
        index = 1;
        ajaxmark = 2;   // 標記為進行中

        var retrun_var = excel_export_ajax(index, num, processnum, tabletype);

        if (typeof (retrun_var) == 'undefined') {
            iii++;                       // 前進到下一個表
            excel_export2(num, processnum);
            if (iii > 100) { return false; }
        } else if (retrun_var == 'success') {
            return false;
        }
        return false;
    } else {
        // 每隔 3 秒回頭檢查上一個請求是否結束
        setTimeout(_excel_export2(num, processnum), 3000);
    }
}

function _excel_export2(num, processnum) {
    return function () {
        excel_export2(num, processnum);
    };
}

這裡有個 JavaScript 經典陷阱值得說明:setTimeout(excel_export2(num, processnum), 3000) 是錯的寫法,因為它會立刻執行 excel_export2,再把它的回傳值當計時器參數。正確做法是包一層匿名函式,讓它回傳真正的函式——這就是 _excel_export2 存在的理由。或者直接用 setTimeout(function () { excel_export2(num, processnum); }, 3000),更直觀。

實際發送批次請求

function excel_export_ajax(index, num, processnum, tabletype) {
    $.ajax({
        url: "<?php echo WEB_URL;?>/index.php?q=onlinesea/exportcsv"
           + search_uri + "/index/" + index + "/total/" + num
           + '/tabletype/' + tabletype,
        type: 'GET',
        success: function (data) {
            ++processed_count;
            ++index;

            // 更新進度條
            var process_num = parseInt((processed_count / processnum) * 100);
            if (process_num >= 100) { process_num = 100; }
            update_process(process_num);

            if (processed_count >= processnum) {
                backup_compress();     // 全部完成,進行壓縮
                return 'success';
            }

            if (data == '0') {
                // 這個表匯完了,切換到下一個
                ajaxmark = 1;
                return false;
            }

            // 這個表還沒完成,遞迴呼叫自己繼續抓下一批
            excel_export_ajax(index, num, processnum, tabletype);
        }
    });
}

/* 更新進度條 */
function update_process(process_num) {
    win.$('#process_bg').show().width(process_num + '%');
    win.$('#process_num').html(process_num);
}

/* 全部完成後進行壓縮 */
function backup_compress() {
    win.$('#progress_info').text('正在生成壓縮文件...');
    $.ajax({
        url: "<?php echo WEB_URL;?>/index.php?q=onlinesea/compress/event/<?php echo $event;?>",
        success: function (msg) {
            win.$('#process_bg').show().width('100%');
            win.$('#process_num').html('100');
            win.$('#progress_info').html(
                '導出數據完成。

這個設計的取捨

優點:每個請求只做一小批,單次執行時間短,不易觸發 PHP 的 max_execution_time 或伺服器逾時;進度條能真實反映完成比例;全部寫完才壓縮,使用者最後下載一個檔案即可。

要注意的地方:

1. 用全域變數協調狀態很脆弱。整個流程依賴 ajaxmark、iii、index 三個全域變數,一旦使用者中途刷新或重複點擊,狀態就會錯亂。較穩健的做法是把狀態收進一個物件或 closure,並在開始時檢查是否已在執行中。

2. 遞迴 + 輪詢的組合不易讀。為何要同時用「遞迴抓下一批」與「每 3 秒檢查」兩種機制?這是為了兼顧「同表續抓」與「跨表切換」。若改用 Promise/async-await 串接,邏輯會清楚很多。

3. 中途中斷沒有續傳。若使用者關掉視窗或網路斷線,已處理的進度就丟了。正式環境通常會把任務狀態寫進資料庫或 cache,讓匯出成為一個可查詢、可續行的背景作業。

4. 更根本的替代方案。大資料量匯出的正解其實是在伺服器端丟背景任務(例如排入 queue 由 worker 處理),前端只負責輪詢進度與最終下載連結。這樣不必維持一條長時間的請求鏈,也不受瀏覽器開著與否的影響。上述的佇列式 Ajax 是在無法改動後端架構時,一個實用且能立即見效的折衷方案。

完整原始碼依此結構組出即可,其中 PHP 端的 getwherecount(統計筆數)、exportcsv(分批輸出,完成回 0、未完成回 1)、compress(打包)三個端點需自行實作。

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