兩者皆為 URL 編碼函數,核心差異在於**空格編碼方式**與**遵循 RFC 標準不同**。
核心差異
| 函數 | 空格編碼 | 遵循標準 | 適用場景 |
urlencode() | + (加號) | application/x-www-form-urlencoded (HTML 表單) | 表單 POST 資料、查詢字串 |
rawurlencode() | %20 | RFC 3986 (URI 標準) | URL 路徑、片段、HTTP Header、OAuth 簽名 |
編碼範圍
- 兩者皆將
- _ . 以外的非英數字元編碼為 %XX。
rawurlencode() 更嚴格符合 URI 標準。
解碼對應
| 編碼函數 | 解碼函數 | 行為差異 |
urlencode() | urldecode() | + → 空格;%XX 任意兩字元皆嘗試解碼 |
rawurlencode() | rawurldecode() | 僅解碼 %[0-9A-Fa-f]{2};+ 保持原樣 |
實務建議
- **查詢字串參數值**:
urlencode()(表單標準)。
- **URL 路徑、Host、Header 值**:
rawurlencode()。
- **OAuth 簽名基底字串**:必須用
rawurlencode()(RFC 5849 規定)。
- 混用會導致空格處理不一致(
+ vs %20),解碼端務必對應正確函數。
範例
$str = 'foo bar@baz';
echo urlencode($str); // foo+bar%40baz
echo rawurlencode($str); // foo%20bar%40baz
// FTP URL 包含密碼特殊字元
echo 'ftp://user:' . rawurlencode('foo @+%/') . '@example.com/';
// ftp://user:foo%20%40%2B%25%2F@example.com/