$_GET 是 PHP 內建超全域陣列,自動解析 URL 查詢字串(?key=value&foo=bar)為關聯陣列。本文詳細說明運作機制、特性限制、安全風險與最佳實務。
<form action="welcome.php" method="get">
Name: <input type="text" name="name" />
Age: <input type="text" name="age" />
<input type="submit" />
</form>
用戶提交後,瀏覽器導向:
https://example.com/welcome.php?name=Peter&age=37
PHP 自動解析為:
<?php
// $_GET = ['name' => 'Peter', 'age' => '37'];
echo $_GET['name']; // Peter
echo $_GET['age']; // 37
?>
| 特性 | 說明 |
|---|---|
| 可見性 | 參數完整顯示於 URL 列 |
| 長度限制 | 約 2000 字元(瀏覽器/伺服器不同) |
| 書籤/分享 | 可直接複製 URL 分享或加入書籤 |
| 重新整理 | 無副作用,安全重新整理 |
| 快取 | 瀏覽器/Proxy 可能快取 GET 請求 |
| 編碼 | 自動 URL 解碼,空格為 + 或 %20 |
| 陣列支援 | name[]=a&name[]=b → $_GET['name'] = ['a','b'] |
/search?q=php+tutorial/articles?page=3/products?category=book&sort=price_asc/api/users?id=123<?php
// 1. 存在性檢查
if (!isset($_GET['id'])) {
die('缺少必要參數 id');
}
// 2. 型別與格式驗證
$id = filter_input(INPUT_GET, 'id', FILTER_VALIDATE_INT, [
'options' => ['min_range' => 1]
]);
if ($id === false) {
die('無效的 ID 參數');
}
// 3. 字串長度/內容限制
$search = filter_input(INPUT_GET, 'q', FILTER_SANITIZE_STRING);
$search = mb_substr($search, 0, 100); // 限制長度
// 4. 白名單驗證(枚舉值)
$sort = $_GET['sort'] ?? 'date_desc';
$allowedSorts = ['date_asc', 'date_desc', 'price_asc', 'price_desc'];
if (!in_array($sort, $allowedSorts, true)) {
$sort = 'date_desc'; // 重置預設
}
?>
<?php
// 直接輸出到 HTML 內容區
echo htmlspecialchars($_GET['name'] ?? '', ENT_QUOTES, 'UTF-8');
// 輸出到 HTML 屬性值
echo '<input value="' . htmlspecialchars($_GET['name'] ?? '', ENT_QUOTES, 'UTF-8') . '">';
// 輸出到 JavaScript 字串
echo 'const name = ' . json_encode($_GET['name'] ?? '') . ';';
// 輸出到 URL 參數
echo '<a href="page.php?name=' . urlencode($_GET['name'] ?? '') . '">';
?>
<?php
// 原始查詢字串
$queryString = $_SERVER['QUERY_STRING']; // "name=Peter&age=37"
// 重建 URL(保留其他參數)
$currentUrl = 'https://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];
?>
<?php
function removeQueryParam(string $url, string $param): string {
$parts = parse_url($url);
parse_str($parts['query'] ?? '', $query);
unset($query[$param]);
$newQuery = http_build_query($query);
return $parts['path'] . ($newQuery ? '?' . $newQuery : '');
}
$url = 'https://example.com/list?page=3&sort=price&filter=hot';
echo removeQueryParam($url, 'page'); // /list?sort=price&filter=hot
?>
<?php
// HTML 表單
// <input type="checkbox" name="tags[]" value="php">
// <input type="checkbox" name="tags[]" value="js">
$tags = $_GET['tags'] ?? [];
if (!is_array($tags)) $tags = [$tags]; // 防單一值非陣列
// 安全處理每個元素
$tags = array_map(fn($t) => htmlspecialchars($t, ENT_QUOTES, 'UTF-8'), $tags);
?>