您现在的位置：程式碼之家 >> 編程語言 > >> 網頁程式設計 >> PHP 程式設計 >> PHP 相關知識

PHP 啟用 OpenSSL 擴展完整指南：Windows 與 Linux 環境差異化配置

編輯：PHP 相關知識

為什麼需要 OpenSSL？

OpenSSL 是 PHP 進行 HTTPS 請求、數據加解密、證書驗證、數字簽名等核心密碼學操作的基石。常見場景：

file_get_contents('https://...')、cURL HTTPS 請求
支付網關對接（微信支付、支付寶、Stripe 等）
JWT Token 簽名驗證（openssl_sign()/openssl_verify()）
SMTP over TLS/SSL 發送郵件
生成自簽證書、CSR、PFX 等 PKI 操作

檢查是否已啟用：php -m | grep openssl 或 phpinfo() 搜尋 "OpenSSL support => enabled"。

Windows 環境：三步啟用法

修改 php.ini：找到 ;extension=openssl（PHP 7.2+）或 ;extension=php_openssl.dll（舊版），去掉分號註釋。若無此行，手動添加 extension=openssl。
部署依賴 DLL：將 PHP 目錄下的 libssl-*.dll、libcrypto-*.dll 複製到 Apache/bin 或系統 PATH 目錄（如 C:\Windows\System32）。關鍵：DLL 版本必須與 PHP 編譯版本一致（VC15/VS16、x86/x64、Thread Safe/Non Thread Safe）。
重啟 Web 服務：Apache 執行 httpd -k restart，IIS 執行 iisreset /restart 或應用程序池回收。

常見坑點：
• 多 PHP 版本共存時，修改錯誤的 php.ini
• DLL 版本不匹配導致「無法加載動態庫」錯誤（查看 Apache error.log）
• 未重啟服務以致配置不生效
• 線程安全版（TS）與非線程安全版（NTS）混用

Linux 環境：免重編譯動態編譯擴展

以 Ubuntu/CentOS + PHP 5.2~8.x 為例，假設 PHP 安裝路徑為 /usr/local/php（根據實際調整）。

步驟 1：準備源碼包

# 確認當前 PHP 版本
php -v
# 下載對應版本源碼（以 7.4.33 為例）
cd /usr/local/src
wget https://www.php.net/distributions/php-7.4.33.tar.gz
tar xzf php-7.4.33.tar.gz

步驟 2：進入擴展目錄執行 phpize

cd php-7.4.33/ext/openssl
/usr/local/php/bin/phpize
# 若報錯 "Cannot find config.m4"，執行：
mv config0.m4 config.m4
/usr/local/php/bin/phpize

步驟 3：配置編譯參數

./configure --with-php-config=/usr/local/php/bin/php-config --with-openssl
# 若 OpenSSL 庫非標準路徑，指定 --with-openssl-dir=/usr/local/ssl

步驟 4：編譯安裝

make -j$(nproc)
make install
# 輸出提示：Installing shared extensions: /usr/local/php/lib/php/extensions/no-debug-nts-20190902/

步驟 5：註冊擴展並重啟

echo "extension=openssl.so" >> /usr/local/php/etc/php.ini
# 或建議獨立文件：echo "extension=openssl.so" > /usr/local/php/etc/conf.d/openssl.ini
systemctl restart php-fpm   # 或 service php7.4-fpm restart
nginx -s reload             # 若使用 Nginx + PHP-FPM

驗證與排障清單

# 1. 命令行檢查
php -m | grep openssl
php -r "var_dump(OPENSSL_VERSION_TEXT);"

# 2. 代碼驗證
<?php
var_dump(extension_loaded('openssl'));
$ssl = stream_context_create(['ssl'=>['verify_peer'=>false]]);
echo file_get_contents('https://www.google.com', false, $ssl) ? 'HTTPS OK' : 'HTTPS FAIL';
?>

現象	可能原因	排查命令
php -m 無 openssl	擴展未加載	php --ini \| grep Loaded; cat /usr/local/php/etc/php.ini \| grep openssl
啟動報錯 "undefined symbol"	OpenSSL 庫版本不匹配	ldd /usr/local/php/lib/php/extensions/.../openssl.so \| grep ssl
HTTPS 請求失敗	CA 證書缺失	curl -v https://...; 設置 openssl.cafile=/etc/ssl/certs/ca-certificates.crt
PHP-FPM 不生效	未重啟進程	systemctl status php-fpm; kill -USR2 $(cat /run/php-fpm.pid) 熱重載

容器化部署最佳實踐

Dockerfile 中直接安裝系統包，避免手動編譯：

FROM php:8.2-fpm
RUN apt-get update && apt-get install -y libssl-dev \
    && docker-php-ext-install openssl
# 或 Alpine 基礎鏡像
FROM php:8.2-fpm-alpine
RUN apk add --no-cache openssl-dev \
    && docker-php-ext-install openssl

生產環境加固建議

最小權限：僅在需 HTTPS 的 FPM 池啟用，其他池禁用 disable_functions = openssl_*（極少見）。
證書管理：配置 openssl.cafile、openssl.capath 指向系統 CA 憑證包（ca-certificates 包），定期更新。
版本鎖定：Composer platform 配置或基礎鏡像標籤鎖定 OpenSSL 版本，防止系統升級導致 ABI 變更。
監控告警：關注 openssl_error_string()、SSL 握手失敗率、證書過期時間（Prometheus + node_exporter ssl_cert_expiry 指標）。

啟用 OpenSSL 看似簡單，實則涉及編譯工具鏈、動態鏈接庫解析、CA 信任鏈、進程管理等多層知識。Windows 依賴預編譯二進制兼容，Linux 推薦包管理器或 docker-php-ext-install，源碼編譯僅作為特定版本無包源時的備選。掌握驗證腳本與排障矩陣，才能在故障夜晚快速定位、恢復業務。