在 PHP 開發中,經常需要驗證遠端資源(如圖片、文件、API 端點)是否真實存在且可存取。雖然 file_get_contents() 或 get_headers() 也能完成類似任務,但 cURL 提供了更精細的控制、更好的錯誤處理以及對 HTTPS、重定向、超時等複雜場景的原生支援,是判斷遠端檔案存在性的最佳選擇。
判斷檔案是否存在的關鍵在於發送 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";
}
?>
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 表未知)
CURLOPT_NOBODY = false 配合 CURLOPT_RANGE = '0-0' 只下載 1 byte 驗證。FOLLOWLOCATION 時,safe_mode 或 open_basedir 限制會導致錯誤,需檢查 PHP 設定。curl_exec 回傳 false 時,用 curl_error($ch) 取得錯誤訊息記錄日誌。使用 cURL 的 HEAD 請求是 PHP 判斷遠端檔案是否存在的標準、高效且穩健做法。封裝成可複用函式,加上超時、重定向、SSL 驗證等健壯性配置,即可滿足絕大多數業務場景需求。