要匯出幾萬筆資料成 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(打包)三個端點需自行實作。