PHP下載遠程文件到本地：file_get_contents vs cURL 兩種方案完整對比

遠程文件下載：從簡單到健壯的工程化實踐

常見需求：抓取遠程圖片/文件存入本地服務器（如采集、鏡像、遷移）。本文提供兩種方案並分析優劣。

方案一：file_get_contents（簡單、適合小文件）

<?php
function downloadWithFGC(string $url, string $saveDir = '.'): ?string {
    $content = @file_get_contents($url);
    if ($content === false) return null;
    $ext = pathinfo(parse_url($url, PHP_URL_PATH), PATHINFO_EXTENSION) ?: '.bin';
    $filename = $saveDir . '/' . date('YmdHis') . '_' . bin2hex(random_bytes(4)) . $ext;
    if (file_put_contents($filename, $content) === false) return null;
    return $filename;
}

缺點：無超時控制、無重試、無進度、大文件佔用記憶體（一次性讀入）、無法處理重定向/認證/斷點續傳。

方案二：cURL 流式寫入（生產環境推薦）

<?php
function downloadWithCurl(string $url, string $saveDir = '.', array $options = []): ?string {
    $defaults = [
        CURLOPT_TIMEOUT => 30,
        CURLOPT_CONNECTTIMEOUT => 10,
        CURLOPT_FOLLOWLOCATION => true,
        CURLOPT_MAXREDIRS => 5,
        CURLOPT_SSL_VERIFYPEER => true,
        CURLOPT_USERAGENT => 'Mozilla/5.0 (compatible; PHP Downloader)',
    ];
    $ch = curl_init($url);
    curl_setopt_array($ch, $defaults + $options);

    // 獲取文件名
    $ext = '.bin';
    curl_setopt($ch, CURLOPT_HEADERFUNCTION, function($ch, $header) use (&$ext) {
        if (stripos($header, 'Content-Disposition:') === 0) {
            if (preg_match('/filename=["\']?([^"\';]+)/i', $header, $m)) {
                $ext = pathinfo($m[1], PATHINFO_EXTENSION) ? '.' . pathinfo($m[1], PATHINFO_EXTENSION) : $ext;
            }
        } elseif (stripos($header, 'Content-Type:') === 0) {
            $mime = trim(substr($header, 13));
            $extMap = ['image/jpeg'=>'.jpg','image/png'=>'.png','image/gif'=>'.gif','application/pdf'=>'.pdf'];
            $ext = $extMap[$mime] ?? $ext;
        }
        return strlen($header);
    });

    $filename = $saveDir . '/' . date('YmdHis') . '_' . bin2hex(random_bytes(4)) . $ext;
    $fp = fopen($filename, 'wb');
    curl_setopt($ch, CURLOPT_FILE, $fp);
    curl_setopt($ch, CURLOPT_BUFFERSIZE, 8192);

    $result = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    fclose($fp);

    if ($result === false || $httpCode >= 400) {
        @unlink($filename);
        return null;
    }
    return $filename;
}

進階：大文件斷點續傳（Range 請求）

function downloadResumable(string $url, string $dest, int $chunkSize = 1024*1024): bool {
    $fileSize = filesize($dest) ?? 0;
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RANGE => $fileSize . '-',
        CURLOPT_FILE => fopen($dest, 'ab'),
        CURLOPT_FOLLOWLOCATION => true,
        CURLOPT_TIMEOUT => 300,
    ]);
    $result = curl_exec($ch);
    $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    return $result !== false && ($code === 200 || $code === 206);
}

方案選型表

安全提醒

• 驗證 MIME 類型與副檔名一致，防止上傳惡意腳本偽裝圖片。
• 限制下載域名白名單，防 SSRF 攻擊。
• 設置 open_basedir 限制寫入目錄。
• 定期清理臨時文件，防止磁盤佔滿。

掌握 cURL 完整參數，是 PHP 開發者處理網絡 I/O 的核心基本功。

1. 上一篇文章： PHP實現Encode64編碼類：URL安全、可逆、替代Base64的緊湊方案
2. 下一篇文章： PHP強制文件下載：Header 控制瀏覽器彈出「另存為」對話框

PHP 相關知識

PHP 數字分頁類實現：靈活配置、SEO 友好、模板分離

分頁核心邏輯 分頁本質是：總記錄數 ÷ 每頁條數 = 總頁數

ThinkPHP 核心方法 M() 深度解析：模型實例化的輕量級入口

M() 方法是什麼？ 在 ThinkPHP（3.x/5.x/

使用 PHP Imagick 繪製圖像直方圖：完整實作指南

圖像直方圖是數位影像處理中不可或缺的分析工具，它能直觀展示圖

PHP 讀寫 XML 完全指南：DOM、SAX、正則與模板四大方案優劣比較

XML 基礎知識 XML 為資料儲存格式，定義標籤與屬性，不