萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 實作斷點續傳:大檔案分割與合併完整指南

前言

在開發大檔案上傳或下載功能時,斷點續傳是提升用戶體驗的關鍵技術。其核心邏輯在於將大檔案拆分為多個小塊進行傳輸,網路中斷後僅需重傳失敗的分片,最後再於伺服器端合併還原。本文將詳細解析如何使用 PHP 實現檔案的分割與合併,並提供可直接部署的程式碼範例。

核心原理

  • 分割:以二進位模式讀取原始檔案,按固定大小切割,儲存為暫存分片檔案(如 vbcache1.dat、vbcache2.dat...)。
  • 合併:依序讀取分片檔案,寫入目標檔案,直到找不到下一個分片為止。

完整程式碼實作

<?php
// 設定記憶體上限與執行時間,防止大檔案處理時超時
ini_set("memory_limit", "50M");
ini_set("max_execution_time", "300");

$orgFile = 'Fireworks8-chs.exe';      // 來源大檔案
$cacheFileName = 'vbcache';           // 分片暫存檔前綴

/**
 * 分割檔案
 * @param string $fileName 來源檔案路徑
 * @param int $block 每塊大小(位元組)
 */
function cutFile($fileName, $block) {
    global $cacheFileName;
    if (!file_exists($fileName)) return false;

    $num = 1;
    $file = fopen($fileName, 'rb');
    while ($content = fread($file, $block)) {
        $cacheFile = $cacheFileName . $num++ . '.dat';
        $cfile = fopen($cacheFile, 'wb');
        fwrite($cfile, $content);
        fclose($cfile);
    }
    fclose($file);
    echo "分割完成,共 " . ($num - 1) . " 個分片。<br>";
}

/**
 * 合併檔案
 * @param string $targetFile 合併後的目標檔案路徑
 */
function mergeFile($targetFile) {
    global $cacheFileName;
    $num = 1;
    $file = fopen($targetFile, 'wb');
    while ($num > 0) {
        $cacheFile = $cacheFileName . $num++ . '.dat';
        if (file_exists($cacheFile)) {
            $cfile = fopen($cacheFile, 'rb');
            $content = fread($cfile, filesize($cacheFile));
            fclose($cfile);
            fwrite($file, $content);
        } else {
            $num = -1; // 結束迴圈
        }
    }
    fclose($file);
    echo "合併完成:" . $targetFile . "<br>";
}

// 執行範例:將檔案切割為 10MB 一塊
$chunkSize = 10 * pow(2, 20); // 10MB = 10 * 1024 * 1024
cutFile($orgFile, $chunkSize);
mergeFile('ok.exe');
?>

關鍵函數解析

函數用途
fopen($file, 'rb')以二進位唯讀模式開啟檔案,適用於非文字檔案
fread($handle, $length)從檔案指標讀取指定長度的二進位資料
fwrite($handle, $data)將二進位資料寫入檔案指標
pow(2, 20)計算 2 的 20 次方(1,048,576),即 1MB 的位元組數

實務應用建議

  1. 前端配合:搭配 JavaScript (如 File.prototype.slice()) 實現前端分片上傳,後端僅負責接收分片與合併。
  2. 唯一標識:實際專案中應以檔案雜湊值 (MD5/SHA1) + 分片索引命名暫存檔,避免多用戶同時上傳衝突。
  3. 斷點資訊:資料庫記錄 file_hash、total_chunks、uploaded_chunks,支援續傳查詢。
  4. 清理機制:設定排程清理超過 24 小時未完成合併的孤立分片,釋放磁碟空間。

常見問題排查

  • 記憶體不足:調大 memory_limit 或改用流式處理(逐塊讀寫,不載入整個檔案)。
  • 執行逾時:大檔案合併耗時較長,需調整 max_execution_time 或使用 set_time_limit(0)。
  • 權限問題:確保 PHP 執行使用者對暫存目錄具備讀寫權限。

掌握檔案分割與合併技術,是構建高可用檔案傳輸系統的基石。建議在正式環境中引入更健壯的庫(如 league/flysystem 或 resumable.js 配套後端)以應對併發與異常場景。

copyright © 萬盛學電腦網 all rights reserved