如何在PHP 中使用rawurldecode 處理URL 中的特殊字符？

gitbox 2025-05-31

什麼是rawurldecode？

rawurldecode()函數用於對URL編碼的字符串進行解碼。它會將URL中的百分號編碼（如%20表示空格）轉換回原始字符。與urldecode()不同的是， rawurldecode()會嚴格按照RFC 3986標準處理編碼，尤其在處理空格時，它將%20解碼為空格，而不會把加號（ + ）轉換為空格。

這使得rawurldecode()更適合處理路徑部分的URL，而不是查詢字符串中的參數。

 <?php
$encoded = 'https%3A%2F%2Fgitbox.net%2Fpath%2Fwith%20space';
$decoded = rawurldecode($encoded);
echo $decoded;
// 輸出: https://gitbox.net/path/with space
?>

為什麼用rawurldecode而不是urldecode？

urldecode()會將加號+轉換成空格，這是在解析URL查詢參數時的常見需求。
rawurldecode()則嚴格解碼百分號編碼，不會改變加號。

如果你的URL路徑中含有加號且不希望其被轉為空格，應該使用rawurldecode() 。

避免異常情況的注意事項

確保傳入字符串是正確編碼的URL片段<br> 如果輸入字符串中存在未編碼的特殊字符，解碼後可能出現意外字符建議先對URL進行正確編碼。
避免多次解碼<br> 多次調用rawurldecode()可能導致錯誤結果，例如%252 0 （編碼了的編碼）被解碼兩次後變成空格
處理中文和多字節字符<br> 對於UTF-8編碼的URL ， rawurldecode()可以正常解碼，但需要確保編碼統一

示例代碼：處理包含特殊字符的URL

 <?php
// 模擬從外部獲取的URL編碼字符串
$url = 'https%3A%2F%2Fgitbox.net%2Fsearch%3Fq%3Dphp%2Brawurldecode%2520function';

// 使用rawurldecode解碼
$decoded_url = rawurldecode($url);

echo "原始編碼URL: $url\n";
echo "解碼后的URL: $decoded_url\n";

// 輸出:
// 原始編碼URL: https%3A%2F%2Fgitbox.net%2Fsearch%3Fq%3Dphp%2Brawurldecode%2520function
// 解碼后的URL: https://gitbox.net/search?q=php+rawurldecode%20function
?>

通過上面代碼可以看到， rawurldecode()將百分號編碼正確還原，且保持了加號不變。

總結

使用rawurldecode()可以安全地解碼URL路徑中的特殊字符，避免出現加號被誤解為空格的問題。
需要注意避免多次解碼和保證輸入字符串編碼的正確性。
結合具體需求，選擇合適的編碼解碼函數，保證程序穩定運行。

正確使用rawurldecode() ，能夠幫助PHP程序有效處理URL中的特殊字符，避免異常情況的發生，提升程序的健壯性。