萬盛學電腦網

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

PHP 抓取遠端圖片並本地儲存完整實作

核心思路

利用 file_get_contents() 或 fopen() 讀取遠端圖片二進位內容,配合 file_put_contents() 寫入本地檔案。為避免大圖佔用記憶體,建議使用串流複製(stream_copy_to_stream())。

基礎版:輸出緩衝捕獲(適合小圖)

function grabImage($url, $saveName = '') {
    if (!$url) return false;

    // 解析副檔名
    $ext = strtolower(pathinfo(parse_url($url, PHP_URL_PATH), PATHINFO_EXTENSION));
    if (!in_array($ext, ['jpg','jpeg','png','gif','webp','bmp'])) {
        return '不支援的圖片格式';
    }

    $saveName = $saveName ?: time() . '_' . mt_rand(1000,9999) . ".$ext";
    $savePath = __DIR__ . '/images/' . $saveName;

    // 確保目錄存在
    if (!is_dir(dirname($savePath))) {
        mkdir(dirname($savePath), 0755, true);
    }

    // 使用串流複製,低記憶體佔用
    $src = @fopen($url, 'rb');
    if (!$src) return '無法開啟遠端資源';

    $dst = fopen($savePath, 'wb');
    stream_copy_to_stream($src, $dst);
    fclose($src);
    fclose($dst);

    return filesize($savePath) > 0 ? $savePath : false;
}

// 使用範例
$result = grabImage('https://example.com/photo.jpg');
var_dump($result);

進階版:cURL 更可控(支援 Header、Cookie、重導向、超時)

function grabImageCurl($url, $savePath) {
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true,
        CURLOPT_MAXREDIRS      => 5,
        CURLOPT_TIMEOUT        => 30,
        CURLOPT_CONNECTTIMEOUT => 10,
        CURLOPT_USERAGENT      => 'Mozilla/5.0 (compatible; PHP Image Grabber)',
        CURLOPT_SSL_VERIFYPEER => true,  // 生產環境建議 true
        CURLOPT_SSL_VERIFYHOST => 2,
    ]);

    $fp = fopen($savePath, 'wb');
    curl_setopt($ch, CURLOPT_FILE, $fp); // 直接寫入檔案指標

    $success = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $errno = curl_errno($ch);
    $error = curl_error($ch);

    curl_close($ch);
    fclose($fp);

    if (!$success || $httpCode !== 200) {
        @unlink($savePath);
        return "下載失敗: HTTP $httpCode, cURL $errno: $error";
    }
    return $savePath;
}

批量下載範例

$urls = [
    'https://example.com/1.jpg',
    'https://example.com/2.png',
    // ...
];

set_time_limit(0); // 移除執行時間限制
foreach ($urls as $url) {
    $filename = basename(parse_url($url, PHP_URL_PATH));
    $result = grabImageCurl($url, __DIR__ . '/downloads/' . $filename);
    echo "$url => " . (is_string($result) && strpos($result,'失敗')!==false ? "❌ $result" : "✅ $result") . PHP_EOL;
}

避坑指南

  • 防盜鏈:部分網站檢查 Referer,需設定 CURLOPT_REFERER。
  • 重導向循環:設定 CURLOPT_MAXREDIRS 限制跳轉次數。
  • 大檔案記憶體:禁用 file_get_contents() 直接讀大檔,必須用串流或 cURL CURLOPT_FILE 直接寫磁碟。
  • 檔名衝突:加入時間戳、雜湊或 UUID 前綴。
  • 版權合規:僅下載有授權或公開授權圖片,尊重智慧財產權。
copyright © 萬盛學電腦網 all rights reserved