PHP 遠端圖片抓取本地化：完整實作與避坑指南

將遠端圖片下載儲存至本地伺服器，常用於內容遷移、圖床備份、編輯器圖片自動本地化。

核心流程

1. 驗證 URL 合法性
2. 取得副檔名（或從 Content-Type 推斷）
3. 產生本地檔名（時間戳 + 隨機數 + 副檔名，避免衝突）
4. 下載二進位內容
5. 寫入檔案
6. 回傳本地路徑/URL

完整函式實作

<?php
function grabImage($url, $saveDir = '', $filename = '') {
    if (empty($url)) return false;

    // 1. 解析副檔名
    $ext = '';
    if (empty($filename)) {
        $parsed = parse_url($url);
        $path = $parsed['path'] ?? '';
        $ext = strtolower(pathinfo($path, PATHINFO_EXTENSION));
        if (!in_array($ext, ['jpg','jpeg','png','gif','webp','bmp'])) {
            // 嘗試從 Content-Type 獲取
            $headers = @get_headers($url, 1);
            $ctype = $headers['Content-Type'] ?? '';
            $extMap = [
                'image/jpeg' => 'jpg', 'image/png' => 'png',
                'image/gif' => 'gif', 'image/webp' => 'webp',
            ];
            $ext = $extMap[$ctype] ?? 'jpg';
        }
        $filename = date('YmdHis') . '_' . mt_rand(1000,9999) . '.' . $ext;
    }

    // 2. 確保儲存目錄存在
    $saveDir = $saveDir ?: sys_get_temp_dir();
    if (!is_dir($saveDir)) {
        mkdir($saveDir, 0755, true);
    }
    $filepath = rtrim($saveDir, '/') . '/' . $filename;

    // 3. 下載（支援大檔案串流，避免記憶體爆炸）
    $fpRemote = @fopen($url, 'rb');
    if (!$fpRemote) return false;

    $fpLocal = @fopen($filepath, 'wb');
    if (!$fpLocal) {
        fclose($fpRemote);
        return false;
    }

    stream_copy_to_stream($fpRemote, $fpLocal); // 高效串流複製
    fclose($fpRemote);
    fclose($fpLocal);

    // 4. 驗證檔案有效性
    if (filesize($filepath) === 0) {
        unlink($filepath);
        return false;
    }

    return $filepath; // 或回傳相對 Web 根目錄的 URL
}

// 使用範例
$localPath = grabImage('https://example.com/photo.jpg', '/var/www/uploads');
if ($localPath) {
    echo "下載成功：$localPath";
} else {
    echo "下載失敗";
}

關鍵優化點

串流複製 stream_copy_to_stream()

不將整張圖載入記憶體，支援任意大小檔案，效能極佳。

副檔名雙重保險

URL 路徑優先，失敗則回退 Content-Type 推斷。

檔名防衝突

時間戳 + 隨機數，極低機率重複；高併發可加 uniqid() 或 UUID。

目錄自動建立

mkdir(..., true) 遞迴建立，免去部署配置麻煩。

進階擴充

• 圖片壓縮/縮圖：下載後配合 GD/Imagick 壓縮品質、生成縮圖。
• 防盜鏈處理：設定 CURLOPT_REFERER、User-Agent、Cookie 等 Header。
• 重試機制：網路抖動時指數退避重試 3 次。
• 非同步佇列：大量圖片丟入 Redis/RabbitMQ，Worker 後台處理，避免阻塞主流程。

安全提醒

• 嚴格驗證 Content-Type 為圖片類型，防止惡意檔案上傳。
• 儲存目錄設定 open_basedir、禁止執行權限、Nginx/Apache 禁用腳本解析。
• 檔名不信任用戶輸入，一律系統生成。