萬盛學電腦網

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

PHP cURL 實戰心得:封裝、效能與擴展安裝

前言

在微服務架構與第三方 API 整合場景中,cURL 是跨伺服器通訊的首選。本文分享實戰封裝模式、效能優化技巧與擴展安裝排錯指南。

一、通用封裝函數

1. 遠端 POST 請求

function postRemote(string $url, array $data, int $timeout = 30): ?string {
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => $data,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => $timeout,
        CURLOPT_HEADER => false,
        CURLOPT_SSL_VERIFYPEER => true,
    ]);
    $response = curl_exec($ch);
    if (curl_errno($ch)) {
        error_log("cURL POST Error: " . curl_error($ch));
        curl_close($ch);
        return null;
    }
    curl_close($ch);
    return $response;
}

2. 簡易 GET 請求

function getRemote(string $url, int $timeout = 10): ?string {
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => $timeout,
        CURLOPT_HEADER => false,
        CURLOPT_SSL_VERIFYPEER => true,
    ]);
    $response = curl_exec($ch);
    if (curl_errno($ch)) {
        error_log("cURL GET Error: " . curl_error($ch));
        curl_close($ch);
        return null;
    }
    curl_close($ch);
    return $response;
}

二、標準使用流程

  1. 初始化:curl_init()
  2. 配置選項:curl_setopt() / curl_setopt_array()
  3. 執行請求:curl_exec()
  4. 錯誤檢查:curl_errno() / curl_error()
  5. 釋放資源:curl_close()
  6. 處理回應:JSON 解碼、XML 解析等

三、效能特性與優化

  • 支援多執行緒:透過 curl_multi 實現並發,大幅降低串行請求總耗時。
  • 連線重用:相同 Handle 重複請求同域名可復用 TCP/SSL 連線 (Keep-Alive)。
  • DNS 快取:libcurl 內建 DNS 快取,減少解析開銷。
  • 避免頻繁 init/close:批次處理時重用 Handle。

四、PHP cURL 擴展安裝與啟用

Windows 環境

; php.ini
extension=curl

; 確保以下 DLL 存在於 PHP 目錄或系統 PATH:
; libssh2.dll, libeay32.dll, ssleay32.dll (PHP 7.2 前)
; libssl-*.dll, libcrypto-*.dll (PHP 7.2+ OpenSSL 1.1)
; libssh2.dll (SFTP 支援)

重啟 Apache / Nginx / PHP-FPM。

Linux (CentOS/RHEL)

yum install php-curl -y
systemctl restart php-fpm

Linux (Ubuntu/Debian)

apt-get update && apt-get install php-curl -y
systemctl restart php-fpm

Docker

# Dockerfile
FROM php:8.2-fpm
RUN apt-get update && apt-get install -y libcurl4-openssl-dev \
    && docker-php-ext-install curl

驗證安裝

php -m | grep curl
# 或
php -r "var_dump(curl_version());"

五、常見坑點與排錯

現象原因解決
SSL certificate problemCA 憑證缺失或過期更新 ca-bundle.crt 或設定 CURLOPT_CAINFO
Connection timed out防火牆/安全組阻擋、DNS 失敗檢查網路連通性、調整 Timeout
Empty reply from server對方關閉連線、協議不匹配檢查 HTTP/HTTPS、HTTP/2 設定
Memory exhausted大檔案未用串流使用 CURLOPT_WRITEFUNCTION 寫入檔案
Protocol "https" not supported編譯時未啟用 OpenSSL重新編譯或安裝正確套件

六、進階技巧:非阻塞輪詢

// 發起多個請求,輪詢完成狀態
$mh = curl_multi_init();
$chs = [];
foreach ($urls as $i => $url) {
    $chs[$i] = curl_init($url);
    curl_setopt($chs[$i], CURLOPT_RETURNTRANSFER, true);
    curl_multi_add_handle($mh, $chs[$i]);
}

$active = null;
do {
    $mrc = curl_multi_exec($mh, $active);
    if ($mrc != CURLM_OK) { break; }
    // 此處可做其他工作 (非阻塞)
    curl_multi_select($mh, 0.1); // 等待 100ms
} while ($active);

$results = [];
foreach ($chs as $i => $ch) {
    $results[$i] = curl_multi_getcontent($ch);
    curl_multi_remove_handle($mh, $ch);
}
curl_multi_close($mh);

總結

cURL 封裝成服務類、配合依賴注入容器管理生命週期,是現代 PHP 專案的標準做法。重點記住:永遠啟用 SSL 驗證、設定合理超時、使用 curl_multi 做並發、大檔案用串流處理。安裝問題多半是缺少 OpenSSL 開發庫或 DLL 路徑問題,依照作業系統標準安裝流程即可解決。

copyright © 萬盛學電腦網 all rights reserved