PHP file_get_contents 與 cURL 深度對比：選型指南與通用封裝

兩大 HTTP 客戶端函式各有優劣，理解差異並建立通用封裝能應對不同伺服器環境限制。

基本用法對比

file_get_contents (簡單、直觀)

<?php
$content = file_get_contents('https://www.example.com');
echo $content;

cURL (功能豐富、可控性高)

<?php
$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => 'https://www.example.com',
    CURLOPT_RETURNTRANSFER => 1,
    CURLOPT_CONNECTTIMEOUT => 5,
    CURLOPT_TIMEOUT => 10,
]);
$content = curl_exec($ch);
curl_close($ch);
echo $content;

核心差異對照

通用封裝：自動偵測最佳可用方案

<?php
/**
 * 智慧型 HTTP GET 獲取器
 * 優先使用 file_get_contents (效能較好)，失敗回退 cURL
 * @param string $url
 * @param array $options 額外選項
 * @return string|false
 */
function vitaGetUrlContent($url, $options = []) {
    $defaults = [
        'timeout' => 10,
        'connect_timeout' => 5,
        'user_agent' => 'Mozilla/5.0 (compatible; PHP HTTP Client)',
        'headers' => [],
        'follow_location' => true,
        'max_redirects' => 5,
        'verify_ssl' => true,
    ];
    $opts = array_merge($defaults, $options);
    
    // 方案一：file_get_contents (需 allow_url_fopen)
    if (ini_get('allow_url_fopen') && function_exists('file_get_contents')) {
        $context = stream_context_create([
            'http' => [
                'method' => 'GET',
                'timeout' => $opts['timeout'],
                'header' => array_merge([
                    'User-Agent: ' . $opts['user_agent'],
                ], $opts['headers']),
                'follow_location' => $opts['follow_location'] ? 1 : 0,
                'max_redirects' => $opts['max_redirects'],
                'verify_peer' => $opts['verify_ssl'],
                'verify_peer_name' => $opts['verify_ssl'],
            ],
            'ssl' => [
                'verify_peer' => $opts['verify_ssl'],
                'verify_peer_name' => $opts['verify_ssl'],
            ]
        ]);
        
        $content = @file_get_contents($url, false, $context);
        if ($content !== false) return $content;
        // 失敗時不報錯，嘗試 cURL
    }
    
    // 方案二：cURL
    if (function_exists('curl_init')) {
        $ch = curl_init();
        curl_setopt_array($ch, [
            CURLOPT_URL => $url,
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_TIMEOUT => $opts['timeout'],
            CURLOPT_CONNECTTIMEOUT => $opts['connect_timeout'],
            CURLOPT_USERAGENT => $opts['user_agent'],
            CURLOPT_HTTPHEADER => $opts['headers'],
            CURLOPT_FOLLOWLOCATION => $opts['follow_location'],
            CURLOPT_MAXREDIRS => $opts['max_redirects'],
            CURLOPT_SSL_VERIFYPEER => $opts['verify_ssl'],
            CURLOPT_SSL_VERIFYHOST => $opts['verify_ssl'] ? 2 : 0,
        ]);
        
        $content = curl_exec($ch);
        $errno = curl_errno($ch);
        curl_close($ch);
        
        if ($errno === 0) return $content;
    }
    
    // 方案三：Socket (最後手段)
    return @file($url) ? implode('', @file($url)) : false;
}

// 使用範例
$html = vitaGetUrlContent('https://api.example.com/data', [
    'timeout' => 15,
    'headers' => ['Accept: application/json', 'Authorization: Bearer token123'],
]);
if ($html === false) {
    die('所有 HTTP 客戶端均失敗，請檢查網路與 PHP 配置');
}

進階：POST 請求統一封裝

function vitaPostUrl($url, $data, $options = []) {
    $defaults = [
        'timeout' => 30,
        'content_type' => 'application/x-www-form-urlencoded', // 或 application/json
    ];
    $opts = array_merge($defaults, $options);
    
    $postFields = ($opts['content_type'] === 'application/json') 
        ? json_encode($data) 
        : http_build_query($data);
    
    // cURL 是 POST 的唯一可靠選擇
    if (!function_exists('curl_init')) {
        trigger_error('cURL extension required for POST requests', E_USER_WARNING);
        return false;
    }
    
    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => $postFields,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => $opts['timeout'],
        CURLOPT_HTTPHEADER => array_merge([
            'Content-Type: ' . $opts['content_type'],
            'User-Agent: Mozilla/5.0 (compatible; PHP HTTP Client)',
        ], $options['headers'] ?? []),
        CURLOPT_SSL_VERIFYPEER => $options['verify_ssl'] ?? true,
    ]);
    
    $response = curl_exec($ch);
    $errno = curl_errno($ch);
    curl_close($ch);
    
    return $errno === 0 ? $response : false;
}

環境檢查與診斷工具

function checkHttpClientAvailability() {
    $info = [
        'allow_url_fopen' => ini_get('allow_url_fopen') ? 'On' : 'Off',
        'file_get_contents' => function_exists('file_get_contents') ? '可用' : '不可用',
        'curl_extension' => extension_loaded('curl') ? '已載入' : '未載入',
        'curl_version' => function_exists('curl_version') ? curl_version()['version'] : 'N/A',
        'openssl' => extension_loaded('openssl') ? '已載入' : '未載入 (HTTPS 將失敗)',
    ];
    return $info;
}

print_r(checkHttpClientAvailability());

選型決策樹

需要 POST/上傳/並發/精細控制？
    是 → 必須用 cURL
    否 → 
        只是簡單 GET？
            是 → allow_url_fopen=On？ → 是 → file_get_contents (效能最佳)
                                      否 → cURL
            否 → cURL