PHP 經典可逆加密解密函數 authcode 詳解與應用

Discuz! 經典的 authcode 函數是 PHP 開發者廣泛使用的對稱加密工具，支援加密、解密、過期時間、數據完整性驗證。本文深度解析其原理並給出生產級使用建議。

完整函數代碼

function authcode($string, $operation = 'DECODE', $key = '', $expiry = 0) { 
    $ckey_length = 4;                               // 動態密鑰長度 
    $key = md5($key ? $key : $GLOBALS['discuz_auth_key']); 
    $keya = md5(substr($key, 0, 16));               // 加解密密鑰 
    $keyb = md5(substr($key, 16, 16));              // 數據完整性驗證密鑰 
    $keyc = $ckey_length ? ($operation == 'DECODE' ? substr($string, 0, $ckey_length) : substr(md5(microtime()), -$ckey_length)) : ''; 
    
    $cryptkey = $keya . md5($keya . $keyc);         // 參與運算的最終密鑰 
    $key_length = strlen($cryptkey); 
    
    // 明文預處理：時間戳(10) + keyb驗證碼(16) + 原始數據 
    $string = $operation == 'DECODE' 
        ? base64_decode(substr($string, $ckey_length)) 
        : sprintf('%010d', $expiry ? $expiry + time() : 0) . substr(md5($string . $keyb), 0, 16) . $string; 
    
    $string_length = strlen($string); 
    $result = ''; 
    $box = range(0, 255); 
    $rndkey = []; 
    
    // 生成密鑰簿 
    for ($i = 0; $i <= 255; $i++) { 
        $rndkey[$i] = ord($cryptkey[$i % $key_length]); 
    } 
    
    // 打亂密鑰簿（RC4 核心） 
    for ($j = $i = 0; $i < 256; $i++) { 
        $j = ($j + $box[$i] + $rndkey[$i]) % 256; 
        $tmp = $box[$i]; 
        $box[$i] = $box[$j]; 
        $box[$j] = $tmp; 
    } 
    
    // 核心加解密：異或運算 
    for ($a = $j = $i = 0; $i < $string_length; $i++) { 
        $a = ($a + 1) % 256; 
        $j = ($j + $box[$a]) % 256; 
        $tmp = $box[$a]; 
        $box[$a] = $box[$j]; 
        $box[$j] = $tmp; 
        $result .= chr(ord($string[$i]) ^ ($box[($box[$a] + $box[$j]) % 256])); 
    } 
    
    if ($operation == 'DECODE') { 
        // 驗證時間戳與完整性 
        if ((substr($result, 0, 10) == 0 || substr($result, 0, 10) - time() > 0) 
            && substr($result, 10, 16) == substr(md5(substr($result, 26) . $keyb), 0, 16)) { 
            return substr($result, 26); 
        } 
        return ''; 
    } else { 
        // 加密輸出：keyc + base64(加密數據) 
        return $keyc . str_replace('=', '', base64_encode($result)); 
    } 
}

核心機制解析

使用示例

// 加密 
$token = authcode('user_id=10086&action=pay', 'ENCODE', 'my_secret_key', 3600); 
// 輸出如：a1b2 + base64密文 

// 解密 
$data = authcode($token, 'DECODE', 'my_secret_key'); 
// 過期或篡改返回空字符串 
if ($data) { 
    parse_str($data, $params); 
    // $params['user_id'] = 10086 
}

安全性評估與替代方案

• 優點：代碼精簡、無依賴、支援過期時間、完整性驗證
• 缺點：RC4 已被證明存在偏差，不適合高安全場景；無認證加密（AEAD）特性
• 現代替代：
  • openssl_encrypt($data, 'AES-256-GCM', $key, OPENSSL_RAW_DATA, $iv, $tag) — 認證加密，推薦
  • sodium_crypto_aead_xchacha20poly1305_ietf_encrypt() — 現代、抗侧信道
  • JWT (JSON Web Token) — 標準化、跨語言、支援簽名/加密

工程化建議

1. 密鑰管理：使用環境變數或密鑰管理系統（Vault、AWS KMS），不要硬編碼
2. 密鑰輪換：定期輪換，舊密鑰保留一段時間用於解密歷史數據
3. 傳輸加密：敏感數據務必走 HTTPS，防止中間人竊取密文
4. 審計日誌：記錄加解密調用（不記錄明文），便於事後追蹤

authcode 仍是中小項目快速實現 Token、API 簽名、臨時鏈接加密的實用選擇，但新項目建議優先採用 AES-GCM 或 Sodium 庫。