PHP URL 編解碼深度解析：urlencode、rawurlencode 與中文處理實戰

在 Web 開發中，URL 參數傳遞時必須對特殊字元進行編碼，PHP 提供了四組核心函式：urlencode() / urldecode() 與 rawurlencode() / rawurldecode()。兩者差異在於空格處理與 RFC 標準遵循度，本文詳細解析其行為差異、適用場景，並提供中文亂碼解決方案與 Unicode 解碼進階技巧。

一、核心函式對照表

二、urlencode() 與 rawurlencode() 實戰範例

1. 查詢字串編碼（表單提交）

<?php
$userInput = '張三 & 李四';
$url = "search.php?q=" . urlencode($userInput);
// 輸出: search.php?q=%E5%BC%B5%E4%B8%89+%26+%E6%9D%8E%E5%9B%9B
echo '<a href="' . htmlentities($url) . '">搜尋</a>';
?>

關鍵點：輸出至 HTML 屬性時，務必再包一層 htmlentities() 防止 & 被瀏覽器誤解為實體字元。

2. Path 片段編碼（RESTful API、靜態資源）

<?php
$path = 'sales and marketing/Miami';
$url = "https://api.example.com/department/" . rawurlencode($path);
// 輸出: https://api.example.com/department/sales%20and%20marketing%2FMiami
?>

3. FTP URL 嵌入密碼

<?php
$pwd = 'foo @+%/';
$url = "ftp://user:" . rawurlencode($pwd) . "@ftp.example.com/file.txt";
?>

三、解碼陷阱與中文亂碼解決方案

1. 編碼不一致導致亂碼

• 前端 encodeURIComponent()（JS）對應 PHP rawurldecode()。
• 傳統表單提交對應 urldecode()。

2. 頁面編碼非 UTF-8 時的轉碼

<?php
$decoded = urldecode($encodedStr); // 取得 UTF-8 字串
if ('UTF-8' !== mb_internal_encoding()) {
    $decoded = mb_convert_encoding($decoded, mb_internal_encoding(), 'UTF-8');
}
?>

3. 非標準 %uXXXX Unicode 逃逸格式解碼

部分舊系統或 JavaScript escape() 產生 %u4E2D%u6587 格式，標準解碼函式無法處理，需自訂函式：

<?php
function utf8RawUrlDecode($source) {
    $decoded = '';
    $len = strlen($source);
    for ($pos = 0; $pos < $len; $pos++) {
        $ch = $source[$pos];
        if ($ch !== '%') {
            $decoded .= $ch;
            continue;
        }
        $pos++;
        if ($pos >= $len) break;
        $next = $source[$pos];
        if ($next === 'u') { // %uXXXX
            $pos++;
            $hex = substr($source, $pos, 4);
            $pos += 3; // 迴圈再 +1
            $code = hexdec($hex);
            $decoded .= mb_convert_encoding('&#' . $code . ';', 'UTF-8', 'HTML-ENTITIES');
        } else { // %XX
            $hex = $next . $source[$pos + 1];
            $pos += 1;
            $decoded .= chr(hexdec($hex));
        }
    }
    return $decoded;
}

// 測試
echo utf8RawUrlDecode('%u4E2D%u6587'); // 輸出: 中文
?>

四、最佳實踐總結

1. 查詢字串：urlencode() + htmlentities() 輸出 HTML。
2. Path / Header / API：rawurlencode()。
3. 解碼：對應編碼函式成對使用。
4. 統一內部編碼為 UTF-8：資料庫、PHP、HTML、JS 全鏈路 UTF-8，避免轉碼麻煩。
5. 棄用 escape()/unescape()：改用 encodeURIComponent()/decodeURIComponent()。

掌握編解碼細節，能有效避免參數截斷、簽名驗證失敗、中文亂碼等棘手問題，是後端 API 開發的基本功。