ThinkPHP Http 類下載遠端圖片實戰：import 機制、curl_download 參數與業務流程封裝

Http 類位置與引入

ThinkPHP 3.x 核心類庫路徑：ThinkPHP/Lib/ORG/Net/Http.class.php。使用 import('ORG.Net.Http') 自動載入。

核心代碼實現

<?php
namespace Home\Model; // 假設放在 Model 層
use Think\Model;

class ImageModel extends Model {
    /**
     * 獲取書籍封面圖片：優先用本地快取，無則遠端下載
     * @param string $isbn 國際標準書號
     * @return string 本地圖片相對路徑
     */
    public function getCover(string $isbn): string {
        // 1. 查資料庫現有記錄
        $book = $this->where("isbn='$isbn'")->find();
        if ($book && $book['image']) {
            return $book['image']; // 已有本地圖片
        }

        // 2. 遠端獲取圖片 URL (Amazon API 等)
        $remote = \Com\Buyback\QueryAmazon::getImage($isbn); // 外部服務類
        if (empty($remote['ImageURL'])) {
            return 'Public/bookcover/unknownbook.png'; // 預設圖
        }

        // 3. 本地儲存路徑規劃
        $localPath = "Public/bookcover/{$isbn}.jpg";
        $fullPath  = realpath('.') . "/$localPath";

        // 4. 核心：Http::curl_download 遠端下載到本地
        // 參數：$remoteUrl, $localFilePath
        $result = \ORG\Net\Http::curl_download($remote['ImageURL'], $fullPath);

        if ($result) {
            // 5. 更新資料庫記錄
            $data = ['inform_id' => $book['inform_id'] ?? 0, 'image' => $localPath];
            $book ? $this->save($data) : $this->add($data);
            return $localPath;
        }

        return 'Public/bookcover/unknownbook.png'; // 下載失敗回退
    }
}

Http::curl_download 內部原理 (簡化)

public static function curl_download($url, $savePath) {
    $ch = curl_init($url);
    $fp = fopen($savePath, 'wb'); // 二進制寫入
    curl_setopt_array($ch, [
        CURLOPT_FILE => $fp,
        CURLOPT_FOLLOWLOCATION => true,
        CURLOPT_TIMEOUT => 30,
        CURLOPT_SSL_VERIFYPEER => false, // 內網/測試環境可關閉，生產建議開啟
    ]);
    $ret = curl_exec($ch);
    fclose($fp);
    curl_close($ch);
    return $ret !== false && filesize($savePath) > 0;
}

關鍵細節與避坑

1. 目錄預建：下載前確保 Public/bookcover/ 存在且可寫 (mkdir -p、chmod 755)。
2. 檔名衝突：用 ISBN 做檔名天然唯一，避免衝突。
3. 異步化：大量圖片下載應放入隊列 (Redis/RabbitMQ) 背景處理，避免阻塞 HTTP 請求。
4. 錯誤重試：網路抖動常見，建議指數退避重試 3 次。
5. 版權合規：確認遠端圖片來源授權，避免侵權風險。

ThinkPHP 5/6 版本差異

• TP5/6 採用 Composer PSR-4，Http 類通常改用 think\Request、think\facade\Http 或 Guzzle 封裝。
• 推薦直接引入 guzzlehttp/guzzle：Http::get($url)->sink($savePath) 更現代、功能豐富。

總結

ThinkPHP 內建 Http 類提供簡單的 curl_download 靜態方法，適合輕量級遠端圖片拉取。實務中注意目錄權限、異步處理、錯誤重試與版本遷移。新專案建議直接使用 Guzzle 等成熟 HTTP 客戶端。