當 URL 參數值本身包含 &、=、? 等特殊字符時,直接使用 $_SERVER['REQUEST_URI'] 或 $_GET 會導致參數截斷。本文詳細解析原因,提供 urlencode/urldecode、rawurlencode、http_build_query 等完整解決方案。
URL 結構:https://host/path?key1=val1&key2=val2。& 是**參數分隔符**。若 val1 本身含有 &,解析時會被誤認為下一個參數的開始。
// 目標 URL
$target = 'https://xxx/module.php?module=groupbook&view=index&id=2';
// 作為參數傳遞給 logout
$logoutUrl = 'https://xxx/login.php?op=logout&return=' . $target;
// 實際發送:
// https://xxx/login.php?op=logout&return=https://xxx/module.php?module=groupbook&view=index&id=2
// 服務端解析 $_GET['return'] = 'https://xxx/module.php?module=groupbook' // 截斷!
<?php
$target = 'https://xxx/module.php?module=groupbook&view=index&id=2';
$encoded = urlencode($target);
// 結果: http%3A%2F%2Fxxx%2Fmodule.php%3Fmodule%3Dgroupbook%26view%3Dindex%26id%3D2
$logoutUrl = 'https://xxx/login.php?op=logout&return=' . $encoded;
// 服務端接收:
$return = urldecode($_GET['return']);
// 還原: https://xxx/module.php?module=groupbook&view=index&id=2
區別:urlencode 空格編碼為 +,rawurlencode 編碼為 %20。現代 API、OAuth、JWT 等推薦 raw 版本。
$encoded = rawurlencode($target);
// 空格變 %20,更符合標準
$return = rawurldecode($_GET['return']);
避免手動拼接,自動處理編碼、數組、嵌套。
$params = [
'op' => 'logout',
'return' => 'https://xxx/module.php?module=groupbook&view=index&id=2',
'from' => 'admin',
];
$url = 'https://xxx/login.php?' . http_build_query($params);
// 自動生成正確編碼的查詢字符串
<?php
// login.php
session_start();
$returnUrl = $_GET['return'] ?? '/index.php'; // 獲取編碼後的返回地址
// 存入 Session,避免表單提交時丟失
$_SESSION['return_url'] = $returnUrl;
?>
<form action="do_login.php" method="post">
<input type="hidden" name="return" value="<?php echo htmlspecialchars($returnUrl); ?>">
用戶名: <input name="username"><br>
密碼: <input type="password" name="password"><br>
<button>登錄</button>
</form>
<?php
// do_login.php
session_start();
// ... 驗證邏輯 ...
if ($loginSuccess) {
$return = $_SESSION['return_url'] ?? '/index.php';
unset($_SESSION['return_url']);
// 解碼並跳轉
header('Location: ' . rawurldecode($return));
exit;
}
// 頁面生成登錄鏈接時
var currentUrl = encodeURIComponent(window.location.href); // JS 編碼
document.getElementById('loginLink').href = '/login.php?return=' + currentUrl;
// 或使用 URLSearchParams (現代瀏覽器)
var params = new URLSearchParams();
params.set('return', window.location.href);
link.href = '/login.php?' + params.toString();
| 函數 | 空格編碼 | 標準 | 適用場景 |
|---|---|---|---|
urlencode | + | application/x-www-form-urlencoded | 表單提交、傳統 PHP 兼容 |
rawurlencode | %20 | RFC 3986 (URI 標準) | API、URL 構建、現代 Web、OAuth、JWT |
http_build_query | + (可配置) | 自動構建查詢字符串 | 構建複雜查詢參數、避免手動拼接錯誤 |
http_build_query() 構建整個查詢字符串,而非手動拼接。urldecode() / rawurldecode(),PHP $_GET 已自動解碼,但雙重編碼時需手動解碼。htmlspecialchars(urlencode($val)) 防 XSS。encodeURIComponent()(對應 rawurlencode)。掌握編碼/解碼配對,徹底解決 &、=、?、中文、特殊符號導致的參數截斷與亂碼問題。