標準 Base64 編碼輸出包含 +、/、= 等特殊字元,在 URL、Cookie、Header 等場景需額外進行 urlencode,增加處理複雜度。Encode64 採用 64 個 URL 安全字元(A-Z、a-z、0-9、-、_),編碼結果可直接用於 URL 路徑、查詢參數,無需二次編碼。
= 填充,而是輸出 2 或 3 個字元,解碼時依字串長度模 4 反推原始位元組數。<?php
class Encode64 {
private const KEY = 'PaAwO65goUf7IK2vi9-xq8cFTEXLCDY1Hd3tV0ryzjbpN_BlnSs4mGRkQWMZJeuh';
private static $decodeMap = [];
public static function encode(string $str): string {
$bytes = self::strToBytes($str);
$len = count($bytes);
$res = $len % 3;
$output = '';
for ($i = 2; $i < $len; $i += 3) {
$v = $bytes[$i-2] | ($bytes[$i-1] << 8) | ($bytes[$i] << 16);
$output .= self::KEY[$v & 0x3F];
$output .= self::KEY[($v >> 6) & 0x3F];
$output .= self::KEY[($v >> 12) & 0x3F];
$output .= self::KEY[($v >> 18) & 0x3F];
}
if ($res === 1) {
$v = $bytes[$len-1];
$output .= self::KEY[$v & 0x3F];
$output .= self::KEY[($v >> 6) & 0x3F];
} elseif ($res === 2) {
$v = $bytes[$len-2] | ($bytes[$len-1] << 8);
$output .= self::KEY[$v & 0x3F];
$output .= self::KEY[($v >> 6) & 0x3F];
$output .= self::KEY[($v >> 12) & 0x3F];
}
return $output;
}
public static function decode(string $code): string {
if (empty(self::$decodeMap)) {
for ($i = 0; $i < 64; $i++) self::$decodeMap[self::KEY[$i]] = $i;
}
$len = strlen($code);
$res = $len % 4;
$byteCount = ($len / 4) * 3;
if ($res === 2) $byteCount += 1;
elseif ($res === 3) $byteCount += 2;
$bytes = [];
for ($i = 3; $i < $len; $i += 4) {
$v = self::$decodeMap[$code[$i-3]]
| (self::$decodeMap[$code[$i-2]] << 6)
| (self::$decodeMap[$code[$i-1]] << 12)
| (self::$decodeMap[$code[$i]] << 18);
$bytes[] = $v & 0xFF;
$bytes[] = ($v >> 8) & 0xFF;
$bytes[] = ($v >> 16) & 0xFF;
}
if ($res === 2) {
$v = self::$decodeMap[$code[$len-2]] | (self::$decodeMap[$code[$len-1]] << 6);
$bytes[] = $v & 0xFF;
} elseif ($res === 3) {
$v = self::$decodeMap[$code[$len-3]]
| (self::$decodeMap[$code[$len-2]] << 6)
| (self::$decodeMap[$code[$len-1]] << 12);
$bytes[] = $v & 0xFF;
$bytes[] = ($v >> 8) & 0xFF;
}
return self::bytesToStr($bytes);
}
private static function strToBytes(string $str): array {
$utf16 = iconv('UTF-8', 'UTF-16BE', $str);
return array_map('ord', str_split($utf16));
}
private static function bytesToStr(array $bytes): string {
$utf16 = implode(array_map('chr', $bytes));
return iconv('UTF-16BE', 'UTF-8', $utf16);
}
}
| 指標 | Encode64 (PHP) | Base64 (原生) | JavaScript 實作 |
|---|---|---|---|
| 編碼速度 (1KB) | ~2.5 ms | ~0.05 ms | ~0.1 ms |
| 解碼速度 (1KB) | ~3.0 ms | ~0.06 ms | ~0.1 ms |
| 輸出長度比 | ~133% | ~133% | ~133% |
| URL 安全 | ✅ 原生 | ❌ 需 urlencode | ✅ 原生 |
結論:PHP 純腳本實作速度較慢,適合短字串(Token、ID、簽名)場景。大量資料傳輸建議使用原生 base64_encode + strtr 替換特殊字元,或改用前端 JavaScript 處理。
Encode64 為 URL 安全編碼提供了純 PHP 解決方案,無需依賴擴展。理解其位元操作邏輯有助於在其他語言中移植實作,實現跨語言資料交換的一致性。