PHP 文件讀取與遠端請求：fopen() 與 file_get_contents() 深度比較與最佳實踐

前言：兩大核心函數的定位差異

fopen() 與 file_get_contents() 都是 PHP 內建的流操作函數，但設計初衷不同：

• fopen()：底層流控制，返回資源控制代碼，支援逐行讀取、指標移動、寫入、鎖定等精細操作，適合大文件、二進制、需流程控制的場景。
• file_get_contents()：高階便捷封裝，一次性將整個文件/URL 內容讀入字串，代碼簡潔，適合中小型文件、簡單 GET 請求。

本地文件讀取對比

fopen() 逐行讀取（記憶體友善）

<?php
$file = 'large_log.txt';
$handle = fopen($file, 'r');
if (!$handle) {
    throw new RuntimeException("無法開啟文件：{$file}");
}

while (($line = fgets($handle)) !== false) {
    // 處理單行，如解析日誌、過濾關鍵字
    if (str_contains($line, 'ERROR')) {
        error_log($line);
    }
}

if (!feof($handle)) {
    error_log("讀取過程發生錯誤");
}
fclose($handle); // 必須釋放資源
?>

file_get_contents() 一次性讀取（簡潔但佔記憶體）

<?php
$content = @file_get_contents('config.json');
if ($content === false) {
    throw new RuntimeException('讀取配置文件失敗');
}
$config = json_decode($content, true);
// 適用於小於記憶體限制的文件（預設 128MB）
?>

遠端 HTTP 請求對比

fopen() 實現流式下載（支援 Header 控制）

<?php
$url = 'https://api.example.com/large-export.csv';
$context = stream_context_create([
    'http' => [
        'method'  => 'GET',
        'header'  => "Authorization: Bearer YOUR_TOKEN\r\nAccept: text/csv",
        'timeout' => 30,
    ],
    'ssl' => [
        'verify_peer'      => true,
        'verify_peer_name' => true,
    ],
]);

$handle = fopen($url, 'r', false, $context);
if (!$handle) {
    throw new RuntimeException("遠端請求失敗：{$url}");
}

// 邊下載邊處理，避免佔滿記憶體
while (($row = fgetcsv($handle)) !== false) {
    // 處理 CSV 每一行
    processRow($row);
}
fclose($handle);
?>

file_get_contents() 簡單 GET（附帶 Context）

<?php
$url = 'https://api.example.com/user/profile';
$context = stream_context_create([
    'http' => [
        'method' => 'GET',
        'header' => "Authorization: Bearer TOKEN\r\nAccept: application/json",
        'timeout' => 10,
    ],
]);

$response = @file_get_contents($url, false, $context);
if ($response === false) {
    throw new RuntimeException('API 請求失敗');
}
$data = json_decode($response, true);
?>

關鍵差異總結表

進階議題：fclose() 的必要性

許多開發者忽略 fclose()，以為腳本結束會自動釋放。實際上：

• 長時間運行腳本（CLI/Daemon）：未關閉會導致文件描述符洩漏，最終觸發 Too many open files。
• 併發寫入：未釋放鎖會阻塞其他進程。
• 網路流：未正確關閉可能導致連線殘留，影響 Keep-Alive 複用。

最佳實踐：總是配合 try-finally 或 register_shutdown_function 確保關閉。

現代替代方案：Guzzle / cURL

對於複雜 HTTP 需求（POST、檔案上傳、重試、異步、介面驅動），建議使用 GuzzleHttp\Client 或原生 cURL：

<?php
// Guzzle 範例（需 composer require guzzlehttp/guzzle）
$client = new GuzzleHttp\Client(['timeout' => 10]);
$response = $client->get('https://api.example.com/data', [
    'headers' => ['Authorization' => 'Bearer TOKEN'],
]);
$data = json_decode($response->getBody()->getContents(), true);
?>

選擇建議

1. 本地小文件/簡單 API GET → file_get_contents()（最簡潔）
2. 大文件、CSV/日誌逐行處理、需鎖定 → fopen() + fgets()/fgetcsv()
3. 需 POST、JSON、檔案上傳、認證、重試、異步 → Guzzle / cURL
4. PHP 8.1+：可嘗試 file_get_contents() 搭配 stream_context_create() 覆蓋大部分 GET 需求，但 POST 仍建議用 Guzzle。

理解兩者的底層機制與適用邊界，能讓你在面對不同 IO 場景時寫出更健壯、高效的代碼。