萬盛學電腦網

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

Windows 環境 PHP 啟用 cURL 擴展快速指南

三步驟完成配置

  1. 修改 php.ini:尋找 ;extension=php_curl.dll,移除前導分號 → extension=php_curl.dll。
  2. 複製依賴庫:將 PHP 安裝目錄下的三個 DLL 複製至系統路徑:
    • php_curl.dll
    • libeay32.dll (OpenSSL 核心)
    • ssleay32.dll (OpenSSL 附屬)

    目標目錄任選一:

    • C:\Windows\System32 (64 位系統) / C:\Windows\SysWOW64 (32 位 PHP 於 64 位系統)
    • Apache 安裝目錄 bin\ (如 D:\Apache24\bin\) — 推薦,避免污染系統目錄。
  3. 重啟服務:重啟 Apache (或 PHP-FPM/Nginx) 使配置生效。

驗證腳本

<?php
if (function_exists('curl_version')) {
    $info = curl_version();
    echo "cURL 版本: {$info['version']}\n";
    echo "SSL 版本: {$info['ssl_version']}\n";
    echo "支援協定: " . implode(', ', $info['protocols']) . "\n";
} else {
    die("cURL 擴展未載入,請檢查 php.ini 與 DLL 路徑");
}

常見失敗原因排查表

Linux/macOS 一鍵安裝

# Ubuntu/Debian
sudo apt-get update && sudo apt-get install php-curl
sudo systemctl restart php8.3-fpm  # 或 apache2/nginx

# CentOS/RHEL/Rocky
sudo yum install php-curl  # 或 dnf
sudo systemctl restart php-fpm

# macOS (Homebrew)
brew install php@8.3  # 已內建 cURL
# 或單獨安裝擴展
pecl install curl

核心原則:配置檔啟用擴展 + 依賴庫可被動態鏈接器找到 + 重啟進程,三者缺一不可。

copyright © 萬盛學電腦網 all rights reserved
現象原因解決
Apache 啟動報錯 "無法找到 php_curl.dll"PHP 目錄不在 PATH、或 DLL 檔案缺失將 PHP 目錄加入系統 PATH,或複製 php_curl.dll 至 Apache/bin
啟用後 curl_init() 仍報未定義修改錯誤的 php.ini (CLI vs Apache 使用不同配置)用 phpinfo() 確認 Loaded Configuration File 路徑
SSL 請求失敗 (error 60/77)缺少 CA 憑證束下載 cacert.pem,配置 curl.cainfo=/path/to/cacert.pem
版本不匹配 (VC14 vs VC15, TS vs NTS)下載的 PHP 套件與 DLL 編譯版本不一致從 windows.php.net/downloads 官方下載對應版本完整包