萬盛學電腦網

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

PHP cURL 擴充安裝與 SSL 依賴問題完整解決方案

現象

啟用 extension=php_curl.dll 後,Apache 啟動報錯:「無法載入動態程式庫 php_curl.dll」或「找不到模組」。

根本原因

php_curl.dll 依賴 OpenSSL 動態庫:libeay32.dll、ssleay32.dll(PHP 7 以前),以及 PHP 核心 php7ts.dll/php8ts.dll。Windows 系統目錄搜尋順序導致找不到相依 DLL。

方案一:複製 DLL 到系統目錄(傳統、不推薦)

  1. 從 PHP 安裝目錄複製 libeay32.dll、ssleay32.dll、php7ts.dll、php_curl.dll
  2. 貼至 C:\Windows\System32\(64 位系統)或 C:\Windows\SysWOW64\(32 位 PHP 於 64 位系統)
  3. 重啟 Apache

缺點:汙染系統目錄,版本衝突風險高,遷移困難。

方案二:Apache httpd.conf 載入依賴(推薦)

在 httpd.conf 中 LoadModule php7_module ... 之前加入:

# 使用絕對路徑指向 PHP 目錄
LoadFile "D:/php/libeay32.dll"
LoadFile "D:/php/ssleay32.dll"
LoadFile "D:/php/php7ts.dll"

LoadModule php7_module "D:/php/php7apache2_4.dll"
# ... 其他 PHP 設定

原理:Apache 進程啟動時預先載入指定 DLL 至進程記憶體,後續 PHP 模組載入時即可解析相依符號。

方案三:將 PHP 目錄加入系統 PATH(最簡單)

  1. 「此電腦」→ 內容 → 進階系統設定 → 環境變數
  2. 系統變數 Path 編輯,新增 PHP 安裝目錄(如 D:\php\)
  3. 重啟命令提示字元 / Apache 服務生效

優點:Windows 會在 PATH 目錄尋找 DLL,解決相依載入問題,且不汙染 System32。

方案四:PHP 7.2+ 內建 OpenSSL (libcrypto/libssl)

PHP 7.2 起改用 libcrypto-1_1.dll、libssl-1_1.dll(OpenSSL 1.1)。同樣適用方案二或三。

驗證安裝

<?php
phpinfo();
// 搜尋 "curl" 區塊應顯示:
// cURL support => enabled
// cURL Information => 7.xx.x
// Features => AsynchDNS, IPv6, Largefile, NTLM, SSL, libz, TLS-SRP, HTTP2, HTTPS-proxy, etc.
?>

常見坑點

  • Thread Safe vs Non Thread Safe:Apache 模組必須用 TS 版本
  • VC Runtime 版本:PHP 7.4 需 VC15 (VS2017),PHP 8.0+ 需 VC16 (VS2019),需安裝對應 Visual C++ Redistributable
  • php.ini 路徑:確認 Loaded Configuration File 指向正確 ini
  • extension_dir:設為 ext 絕對路徑 D:/php/ext

Linux 系統 (Ubuntu/Debian)

sudo apt update
sudo apt install php-curl php7.4-curl  # 指定版本
sudo systemctl restart apache2
# 或 nginx + php-fpm
sudo systemctl restart php7.4-fpm
copyright © 萬盛學電腦網 all rights reserved