業務常需對敏感資料(ID、Token、URL 參數)進行可逆加密。本文提供兩類方案:自定義輕量加密(短字串、URL 安全)與標準對稱加密 DES/AES(高安全性、跨語言互通)。
原理:隨機 Key + 異或運算 + Base64,含完整性校驗。
<?php
class SimpleCrypt
{
public static function encrypt(string $data, string $key): string
{
$key = hash('sha256', $key, true);
$iv = random_bytes(16);
$cipher = openssl_encrypt($data, 'AES-256-CBC', $key, OPENSSL_RAW_DATA, $iv);
return base64_encode($iv . $cipher);
}
public static function decrypt(string $encrypted, string $key): ?string
{
$key = hash('sha256', $key, true);
$data = base64_decode($encrypted, true);
if ($data === false || strlen($data) < 16) return null;
$iv = substr($data, 0, 16);
$cipher = substr($data, 16);
return openssl_decrypt($cipher, 'AES-256-CBC', $key, OPENSSL_RAW_DATA, $iv);
}
}
// 用法
$key = 'super-secret-key-32bytes!!';
$enc = SimpleCrypt::encrypt('user_id=123&role=admin', $key);
$dec = SimpleCrypt::decrypt($enc, $key);
?>
優點:AES-256-CBC 標準、隨機 IV 防重放、Base64 URL 安全(`strtr($enc, '+/', '-_')`)。缺點:無簽名驗證,若需防篡改請加 HMAC。
<?php
class DesCrypt
{
private string $key; // 8 bytes
private string $iv; // 8 bytes
public function __construct(string $key, string $iv = '')
{
if (strlen($key) !== 8) throw new InvalidArgumentException('DES key must be 8 bytes');
$this->key = $key;
$this->iv = $iv ?: $key;
}
public function encrypt(string $data): string
{
$padded = $this->pkcs5Pad($data, 8);
$enc = mcrypt_encrypt(MCRYPT_DES, $this->key, $padded, MCRYPT_MODE_CBC, $this->iv);
return strtoupper(bin2hex($enc));
}
public function decrypt(string $hex): string
{
$bin = $this->hex2bin(strtolower($hex));
$dec = mcrypt_decrypt(MCRYPT_DES, $this->key, $bin, MCRYPT_MODE_CBC, $this->iv);
return $this->pkcs5Unpad($dec);
}
private function hex2bin(string $hex): string { return hex2bin($hex); }
private function pkcs5Pad(string $text, int $block): string {
$pad = $block - (strlen($text) % $block);
return $text . str_repeat(chr($pad), $pad);
}
private function pkcs5Unpad(string $text): string {
$pad = ord($text[strlen($text)-1]);
return substr($text, 0, -$pad);
}
}
// 測試
$des = new DesCrypt('1234abcd');
$enc = $des->encrypt('12345678'); // 3132333435363738...
$dec = $des->decrypt($enc); // 12345678
?>
警告:`mcrypt` 擴展已於 PHP 7.2 移除。新專案**嚴禁使用 DES**,改用 `openssl_encrypt` AES。僅維護舊系統互通時使用,並計劃遷移。
<?php
function encodeParams(array $params): string
{
return rtrim(strtr(base64_encode(json_encode($params)), '+/', '-_'), '=');
}
function decodeParams(string $str): ?array
{
$str = strtr($str, '-_', '+/');
$json = base64_decode($str . str_repeat('=', (4 - strlen($str) % 4) % 4), true);
return $json ? json_decode($json, true) : null;
}
// 使用
$url = '/api/user?' . http_build_query(['data' => encodeParams(['id'=>123, 'token'=>'abc'])]);
// 解碼
$params = decodeParams($_GET['data']);
?>
| 場景 | 推薦方案 |
|---|---|
| 內部 API、Token、短連結 | AES-256-GCM(帶認證加密)或 NaCl `sodium_crypto_secretbox` |
| 跨語言(Java/Go/Node)互通 | AES-256-CBC + PKCS7 + Base64,協商 Key/IV 派生方式 |
| 舊系統 DES 互通 | openssl_encrypt DES-EDE3-CBC (3DES) 替代 mcrypt |
| 單純混淆、非敏感 | Base62/URL-Safe Base64 + 簽名 |