萬盛學電腦網

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

PHP 開啟 OpenSSL (SSL) 完整教學:php.ini 設定、DLL 複製與驗證步驟

問題現象

當 PHP 存取 HTTPS 資源 (如 file_get_contents('https://...')、cURL、SoapClient) 時,若出現 did you forget to enable it when you configured PHP 錯誤,表示 OpenSSL 模組未啟用。

解決步驟 (Windows 環境)

步驟 1:修改 php.ini 啟用擴充模組

  1. 找到 php.ini (可透過 php --ini 或 phpinfo() 確認路徑)。
  2. 搜尋 extension=php_openssl.dll。
  3. 移除行首分號 ; 取消註解:
;extension=php_openssl.dll   ← 修改前
extension=php_openssl.dll    ← 修改後

步驟 2:複製相依 DLL 到系統目錄 (關鍵步驟)

OpenSSL 依賴 libeay32.dll 與 ssleay32.dll。將 PHP 目錄下這兩個檔案複製到 C:\Windows\System32 (或 Apache/bin 目錄):

  • libeay32.dll
  • ssleay32.dll
  • php_openssl.dll (通常在 ext/ 目錄)

注意:64 位元系統請放入 C:\Windows\System32 (64 位元 DLL) 與 C:\Windows\SysWOW64 (32 位元 DLL) 視 PHP 版本而定。

步驟 3:重新啟動 Web 伺服器

  • Apache:重啟 Apache 服務。
  • Nginx + PHP-FPM:重啟 PHP-FPM 服務 (systemctl restart php-fpm 或重啟進程)。
  • IIS:回收應用程式集區或執行 iisreset。

驗證是否生效

  1. 建立 info.php:<?php phpinfo(); ?>
  2. 瀏覽器開啟,搜尋 OpenSSL 區塊。
  3. 確認 OpenSSL support => enabled 及版本資訊顯示正常。

Linux 環境 (Ubuntu/Debian/CentOS) 快速安裝

# Ubuntu/Debian
sudo apt-get install php-openssl
sudo systemctl restart php8.1-fpm  # 或對應版本

# CentOS/RHEL
sudo yum install php-openssl
sudo systemctl restart php-fpm

Linux 通常不需手動複製 DLL,套件管理器會自動處理相依性。

常見坑點

  • 修改錯誤的 php.ini:CLI 與 FPM/Apache 可能使用不同 ini,請以 phpinfo() 顯示的 Loaded Configuration File 為準。
  • 忘記重啟服務:修改 ini 後必須重啟 PHP 進程。
  • DLL 版本不符:複製 DLL 時請確保與 PHP 版本 (VC 編譯版本、執行緒安全性) 相符。
  • openssl.cafile 設定:若驗證憑證失敗,需在 php.ini 設定 openssl.cafile=/path/to/cacert.pem。

結語

啟用 OpenSSL 只需三步驟:修改 ini → 複製 DLL (Windows) → 重啟服務。透過 phpinfo() 驗證即可確認。若仍失效,檢查錯誤日誌與 DLL 相依性通常能找到原因。

copyright © 萬盛學電腦網 all rights reserved