PHP 啟用 cURL 擴展完整指南：Windows/Linux 環境配置與驗證

前言

cURL 是 PHP 中進行 HTTP 請求、檔案傳輸、API 串接的核心工具。預設安裝往往未啟用此擴展，本文提供 Windows (IIS/Apache) 與 Linux 環境的完整啟用步驟，並附上驗證腳本。

Windows 環境 (PHP + Apache/IIS)

1. 修改 php.ini：尋找 ;extension=php_curl.dll，移除前方分號 ;。
2. 複製相依 DLL：將 PHP 目錄下 ext/php_curl.dll、libeay32.dll、ssleay32.dll 複製至系統目錄（如 C:\Windows\System32）或 Apache/bin 目錄。
3. 重啟 Web Server：重啟 Apache 或 IIS 使設定生效。

Linux 環境 (Ubuntu/Debian/CentOS)

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

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

驗證 cURL 是否啟用

建立 test_curl.php：

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://www.baidu.com");
curl_setopt($ch, CURLOPT_HEADER, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$output = curl_exec($ch);
if (curl_errno($ch)) {
    echo "cURL Error: " . curl_error($ch);
} else {
    echo "cURL 運作正常！回應長度：" . strlen($output);
}
curl_close($ch);

瀏覽器訪問該檔案，若顯示「cURL 運作正常」即代表啟用成功。

常見問題排查

• DLL 衝突：Windows 上若有多個 PHP 版本，確保複製的 DLL 與執行中的 PHP 版本一致（VC 編譯版本、Thread Safe/Non-Thread Safe）。
• SELinux 阻擋：CentOS 上可能需執行 setsebool -P httpd_can_network_connect 1。
• 憑證問題：若 HTTPS 請求失敗，可設定 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false) 或指定 CURLOPT_CAINFO 為有效 CA 憑證包。

總結

啟用 cURL 只需幾個步驟，關鍵在於正確處理相依庫與重啟服務。驗證腳本可快速確認環境就緒，後續即可放心使用 cURL 進行各類網路操作。