萬盛學電腦網

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

PHP 實作 Encode64 編碼類:URL 安全的 Base64 替代方案

前言

標準 Base64 編碼輸出包含 +、/、= 等特殊字元,在 URL、Cookie、Header 等場景需額外進行 urlencode,增加處理複雜度。Encode64 採用 64 個 URL 安全字元(A-Z、a-z、0-9、-、_),編碼結果可直接用於 URL 路徑、查詢參數,無需二次編碼。

演算法原理

  • 字元表:64 個可列印、無需跳脫的 ASCII 字元,自定義順序增加輕度混淆效果。
  • 位元分組:每 3 位元組(24 bits)分為 4 組 6 bits,對應字元表索引。
  • 填充處理:不足 3 位元組時,不使用 = 填充,而是輸出 2 或 3 個字元,解碼時依字串長度模 4 反推原始位元組數。
  • UTF-16BE 內部編碼:支援 Unicode 字元,內部以 UTF-16BE 處理,確保中日韓文字正確編碼。

完整類別實作

<?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 解決方案,無需依賴擴展。理解其位元操作邏輯有助於在其他語言中移植實作,實現跨語言資料交換的一致性。

copyright © 萬盛學電腦網 all rights reserved