萬盛學電腦網

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

PHP 使用 cURL 判斷遠端檔案是否存在的實作方法

前言

在 PHP 開發中,經常需要驗證遠端資源(如圖片、文件、API 端點)是否真實存在且可存取。雖然 file_get_contents() 或 get_headers() 也能完成類似任務,但 cURL 提供了更精細的控制、更好的錯誤處理以及對 HTTPS、重定向、超時等複雜場景的原生支援,是判斷遠端檔案存在性的最佳選擇。

核心原理:HEAD 請求

判斷檔案是否存在的關鍵在於發送 HTTP HEAD 請求。HEAD 請求僅獲取回應標頭(Header),不下載實際內容(Body),因此極其輕量、快速。我們只需檢查回應的 HTTP 狀態碼是否為 200 OK 即可確認資源存在。

完整程式碼範例

<?php
/**
 * 檢查遠端檔案是否存在
 *
 * @param string $url 目標 URL
 * @param int $timeout 連線超時秒數,預設 10 秒
 * @return bool true 存在,false 不存在或發生錯誤
 */
function check_remote_file_exists(string $url, int $timeout = 10): bool
{
    // 1. 初始化 cURL 會話
    $ch = curl_init($url);

    // 2. 設定核心選項
    curl_setopt_array($ch, [
        CURLOPT_NOBODY        => true,        // 只取標頭,不取內容 (HEAD 請求)
        CURLOPT_RETURNTRANSFER => true,       // 回傳結果而非直接輸出
        CURLOPT_FOLLOWLOCATION => true,       // 自動追蹤 3xx 重定向
        CURLOPT_CONNECTTIMEOUT => $timeout,   // 連線超時
        CURLOPT_TIMEOUT        => $timeout,   // 執行總超時
        CURLOPT_SSL_VERIFYPEER => false,      // 生產環境建議開啟並配置 CA 憑證
        CURLOPT_USERAGENT      => 'Mozilla/5.0 (compatible; PHP cURL Checker)', // 模擬瀏覽器
    ]);

    // 3. 執行請求
    $result = curl_exec($ch);

    // 4. 判斷邏輯
    $found = false;
    if ($result !== false) {
        // 獲取 HTTP 狀態碼
        $statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        // 200 代表成功,部分情況 301/302 經 FOLLOWLOCATION 後也會變 200
        // 若需嚴格判斷「最終資源存在」,200 是標準依據
        if ($statusCode === 200) {
            $found = true;
        }
    }

    // 5. 關閉釋放資源
    curl_close($ch);

    return $found;
}

// --- 使用示範 ---
$testUrl = 'https://www.example.com/image.png';
if (check_remote_file_exists($testUrl)) {
    echo "遠端檔案存在:$testUrl";
} else {
    echo "遠端檔案不存在或無法存取:$testUrl";
}
?>

關鍵參數詳解

  • CURLOPT_NOBODY = true:核心開關,發送 HEAD 請求,不下載 Body,節省頻寬與時間。
  • CURLOPT_FOLLOWLOCATION = true:自動處理 301/302 重定向,直接取得最終資源的狀態碼。
  • CURLOPT_CONNECTTIMEOUT / CURLOPT_TIMEOUT:防止腳本因網路不通長時間卡死,生產環境務必設定。
  • CURLOPT_SSL_VERIFYPEER:開發測試可設 false 忽略憑證驗證;正式環境請設為 true 並配置 CURLOPT_CAINFO。

進階:獲取更多資訊

若需要知道檔案大小、類型(MIME)或最後修改時間,可在 curl_exec 成功後使用 curl_getinfo() 取得:

$info = curl_getinfo($ch);
$fileSize   = $info[CURLINFO_CONTENT_LENGTH_DOWNLOAD]; // 檔案大小 (bytes)
$mimeType   = $info[CURLINFO_CONTENT_TYPE];            // 例如 image/png
$modifyTime = $info[CURLINFO_FILETIME];                // 最後修改時間 (Unix timestamp, -1 表未知)

常見坑點與最佳實踐

  1. 別只信 200:某些 CDN 或伺服器對 HEAD 請求回 403/405,但 GET 卻正常。必要時可改用 CURLOPT_NOBODY = false 配合 CURLOPT_RANGE = '0-0' 只下載 1 byte 驗證。
  2. 重定向陷阱:開啟 FOLLOWLOCATION 時,safe_mode 或 open_basedir 限制會導致錯誤,需檢查 PHP 設定。
  3. 錯誤處理:curl_exec 回傳 false 時,用 curl_error($ch) 取得錯誤訊息記錄日誌。
  4. 效能優化:批次檢查大量 URL 時,考慮使用 cURL Multi (多執行緒並發) 大幅縮短總耗時。

總結

使用 cURL 的 HEAD 請求是 PHP 判斷遠端檔案是否存在的標準、高效且穩健做法。封裝成可複用函式,加上超時、重定向、SSL 驗證等健壯性配置,即可滿足絕大多數業務場景需求。

copyright © 萬盛學電腦網 all rights reserved