萬盛學電腦網

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

PHP 獲取 URL 參數中包含 & 符號的完整值:urlencode 編碼與解碼實戰

當 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'  // 截斷!

解決方案:編碼參數值

1. urlencode() / urldecode()(最常用,表單標準)

<?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

2. rawurlencode() / rawurldecode()(RFC 3986 標準,推薦)

區別:urlencode 空格編碼為 +,rawurlencode 編碼為 %20。現代 API、OAuth、JWT 等推薦 raw 版本。

$encoded = rawurlencode($target);
// 空格變 %20,更符合標準
$return = rawurldecode($_GET['return']);

3. http_build_query() 構建整個查詢字符串(最佳實踐)

避免手動拼接,自動處理編碼、數組、嵌套。

$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);
// 自動生成正確編碼的查詢字符串

完整實戰流程:登錄後跳轉返回原頁

步驟 1:登錄頁保存目標 URL(編碼)

<?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>

步驟 2:登錄處理後跳轉(解碼)

<?php
// do_login.php
session_start();
// ... 驗證邏輯 ...
if ($loginSuccess) {
    $return = $_SESSION['return_url'] ?? '/index.php';
    unset($_SESSION['return_url']);
    // 解碼並跳轉
    header('Location: ' . rawurldecode($return));
    exit;
}

JavaScript 端配合

// 頁面生成登錄鏈接時
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%20RFC 3986 (URI 標準)API、URL 構建、現代 Web、OAuth、JWT
http_build_query+ (可配置)自動構建查詢字符串構建複雜查詢參數、避免手動拼接錯誤

最佳實踐原則

  1. 凡是作為 URL 參數值的動態內容,必須編碼。
  2. 優先使用 http_build_query() 構建整個查詢字符串,而非手動拼接。
  3. 接收端對應解碼: urldecode() / rawurldecode(),PHP $_GET 已自動解碼,但雙重編碼時需手動解碼。
  4. 輸出到 HTML 時雙重防護: htmlspecialchars(urlencode($val)) 防 XSS。
  5. JavaScript 端用 encodeURIComponent()(對應 rawurlencode)。

掌握編碼/解碼配對,徹底解決 &、=、?、中文、特殊符號導致的參數截斷與亂碼問題。

copyright © 萬盛學電腦網 all rights reserved