萬盛學電腦網

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

PHP OpenSSL 擴展 (php_openssl.dll) 功能詳解與指令操作實戰

OpenSSL 擴展簡介

php_openssl.dll 提供 PHP 呼叫 OpenSSL 庫功能:對稱/非對稱加密、數位簽名、證書管理、TLS/SSL 通訊、PKCS#7/12 處理等。是實作 HTTPS 客戶端、API 簽名驗證、支付加密、憑證產生的基礎。

核心功能

  • 金鑰管理:生成 RSA/DSA/EC 金鑰對、讀取 PEM/DER、轉換格式。
  • 加密/解密:openssl_public_encrypt/decrypt、openssl_private_encrypt/decrypt、對稱加密 openssl_encrypt/decrypt (AES 等)。
  • 簽名/驗證:openssl_sign/verify、openssl_digest (雜湊)。
  • 證書操作:CSR 產生、自簽證書、X.509 解析、驗證鏈。
  • 封裝格式:PKCS#7 (S/MIME)、PKCS#12 (PFX/P12)。
  • TLS/SSL 串流:stream_socket_client/server 搭配 ssl:// 協定。

命令列工具實戰 (openssl CLI)

PHP 擴展底層即呼叫同一組庫,CLI 適合離線金鑰管理、除錯。

1. 生成私鑰

# RSA 2048 位元,無密碼
openssl genrsa -out private.pem 2048

# RSA 2048,AES-256 加密私鑰 (需輸入密碼)
openssl genrsa -aes256 -out private_enc.pem 2048

# DSA 參數 + 金鑰
openssl dsaparam -out dsaparam.pem 2048
openssl gendsa -out dsa_private.pem dsaparam.pem

2. 導出公鑰

openssl rsa -in private.pem -pubout -out public.pem
openssl dsa -in dsa_private.pem -pubout -out dsa_public.pem

3. 自簽證書 (開發/測試用)

# RSA 自簽,有效期 365 天
openssl req -x509 -new -key private.pem -days 365 -out cert.pem -subj "/CN=localhost"

# 產生 CSR (送 CA 簽署)
openssl req -new -key private.pem -out csr.pem -subj "/CN=example.com"

4. S/MIME 郵件/檔案加密

# 加密 (用公開鑰/證書)
openssl smime -encrypt -in plain.txt -out encrypted.p7m -outform DER cert.pem

# 解密 (用私鑰)
openssl smime -decrypt -in encrypted.p7m -inform DER -inkey private.pem -out decrypted.txt

5. 對稱加密 (檔案/字串)

# AES-256-CBC 加密檔案 (互動輸入密碼)
openssl enc -aes-256-cbc -salt -in plain.txt -out encrypted.bin

# 解密
openssl enc -d -aes-256-cbc -in encrypted.bin -out plain.txt

# Base64 編碼/解碼 (非加密,單純編碼)
echo "secret" | openssl enc -base64
echo "c2VjcmV0Cg==" | openssl enc -base64 -d

6. SSL/TLS 客戶端/伺服器測試

# 啟動測試 HTTPS 伺服器 (需證書+私鑰)
openssl s_server -key private.pem -cert cert.pem -www -accept 4433

# 客戶端連線測試
openssl s_client -connect localhost:4433 -showcerts

PHP 程式碼對應操作

<?php
// 對稱加密 (推薦使用 openssl_encrypt, PHP 7.1+ 支援 AEAD 模式如 AES-GCM)
$data = '機密資料';
$key = random_bytes(32); // 256-bit
$iv = random_bytes(16);  // 128-bit IV
$cipher = 'aes-256-gcm';
$encrypted = openssl_encrypt($data, $cipher, $key, OPENSSL_RAW_DATA, $iv, $tag);
$decrypted = openssl_decrypt($encrypted, $cipher, $key, OPENSSL_RAW_DATA, $iv, $tag);

// 非對稱加密
$pub = openssl_pkey_get_public(file_get_contents('public.pem'));
$priv = openssl_pkey_get_private(file_get_contents('private.pem'));
openssl_public_encrypt($data, $enc, $pub);
openssl_private_decrypt($enc, $dec, $priv);

// 簽名驗證
openssl_sign($data, $sig, $priv, 'sha256');
$valid = openssl_verify($data, $sig, $pub, 'sha256');

openssl_free_key($pub);
openssl_free_key($priv);
?>

常見問題排查

  • Call to undefined function openssl_*:未啟用擴展、PHP 版本不匹配 (TS/NTS)、libeay32.dll/ssleay32.dll (Windows) 未在 PATH。
  • SSL 驗證失敗:缺少 CA 憑證束,設定 curl.cainfo/openssl.cafile 指向 cacert.pem。
  • 金鑰長度限制:RSA 直接加密資料長度 < キー長度/8 - 11 (PKCS#1 v1.5),大資料必須用混合加密。
copyright © 萬盛學電腦網 all rights reserved