php 获取url参数

一、php 获取url参数基础入门

在PHP开发中,php 获取url参数是最基础且高频操作。URL参数(又称查询字符串)位于URL中问号(?)之后,以键值对形式存在,例如:https://www.xservx.com?name=php&version=8.2。

PHP提供了多种方式获取这些参数,其中最常用的是通过超全局变量$_GET。当用户访问一个带有查询参数的URL时,PHP会自动解析这些参数并填充到$_GET数组中,供开发者直接使用。

⚡ $_GET 的基本用法

$_GET 是一个关联数组,键为参数名,值为参数值。例如访问:
https://www.xservx.com?user=alice&id=123

<?php
// 假设当前URL为 ?user=alice&id=123
echo $_GET['user'];  // 输出:alice
echo $_GET['id'];    // 输出:123
// 安全检查:避免未定义索引错误
if (isset($_GET['user'])) {
    echo '用户名:' . htmlspecialchars($_GET['user']);
}
?>

⚠️ 注意:当参数值包含特殊字符(如空格、中文、符号)时,浏览器会自动进行URL编码。PHP在解析$_GET时会自动进行URL解码,但解码规则遵循RFC 3986标准,例如空格会被解码为+,%20会被解码为空格。

⚙️ URL编码与解码原理

URL参数必须符合URL规范,因此特殊字符需编码。常见编码示例:

原始字符URL编码PHP解码结果
空格%20 或 +空格
中文"测试"%E6%B5%8B%E8%AF%95测试
等号=%3D=
与号&%26&
问号?%3F?

PHP中对应函数:

  • urlencode():对字符串进行URL编码(RFC 1738)
  • rawurlencode():对字符串进行URL编码(RFC 3986,更推荐)
  • urldecode():对字符串进行URL解码
  • rawurldecode():按RFC 3986规则解码

在实际开发中,建议优先使用rawurlencode()和rawurldecode(),因其符合现代URL标准,避免+被误解析为空格的问题。

二、php 获取url参数的五种核心方法对比

除了$_GET,PHP还提供多种方式获取URL参数,适用于不同场景。以下对五种主流方法进行系统对比:

〔1〕$_GET —— 最常用但有限制

优点:自动解析,简单直接;
缺点:仅支持GET请求;参数值被自动解码;无法获取原始查询字符串。

〔2〕$_SERVER['QUERY_STRING'] —— 原始查询字符串

获取完整的未解析查询字符串(URL中?之后的部分),包含编码字符。

<?php
// 访问:?user=张三&msg=hello%20world
echo $_SERVER['QUERY_STRING'];
// 输出:user=%E5%BC%A0%E4%B8%89&msg=hello+world
// 手动解析(可选)
parse_str($_SERVER['QUERY_STRING'], $params);
print_r($params);
// 输出:Array ( [user] => 张三 [msg] => hello world )
?>

〔3〕parse_url() + parse_str() —— 精准解析

适用于从完整URL中提取参数,尤其适合处理外部来源的URL(如API回调)。

<?php
$url = 'https://api.example.com/callback?code=abc123&state=xyz';
$parts = parse_url($url);
parse_str($parts['query'], $query);
echo $query['code']; // abc123
?>

〔4〕http_build_query() —— 构建查询字符串

用于生成符合规范的查询字符串,常用于构建重定向URL或API请求参数。

<?php
$params = [
    'user' => '张三',
    'msg'  => 'hello world',
    'tags' => ['php', 'url']
];
$query = http_build_query($params);
// 输出:user=%E5%BC%A0%E4%B8%89&msg=hello+world&tags%5B0%5D=php&tags%5B1%5D=url
// 可自定义分隔符
$query = http_build_query($params, '', '&');
?>

〔5〕filter_input() —— 安全过滤首选

PHP内置过滤函数,可对输入进行验证和清理,防止XSS等攻击。

<?php
// 获取并过滤GET参数:只允许字母数字、下划线、连字符
$username = filter_input(INPUT_GET, 'user', FILTER_SANITIZE_STRING);
$email    = filter_input(INPUT_GET, 'email', FILTER_VALIDATE_EMAIL);
if ($email === false) {
    echo '无效邮箱格式';
}
?>

① $_GET 特性详解

php 获取url参数时,$_GET是最直接的方式,但其行为在不同PHP版本中略有差异:

  • PHP 7.4+:$_GET会自动解码所有参数,包括嵌套数组(如?a[]=1&a[]=2)
  • PHP 8.0+:弃用FILTER_SANITIZE_STRING,建议改用filter_var()
  • 参数名含点号(如?user.name=alice)会被自动转为下划线($_GET['user_name']),这是PHP的已知行为,因点号在数组键中非法

典型案例:在WordPress中,URL重写规则会将?p=123转为/archives/123,但底层仍通过$_GET['p']识别文章ID。

② parse_url() 高级用法

parse_url()可提取URL各组成部分,配合parse_str()实现精准参数提取:

<?php
$url = 'https://example.com/path/file.php?param1=value1#section';
var_dump(parse_url($url));
// 提取参数时避免污染$_GET全局变量
parse_str('param1=value1', $params);
// $params 是独立数组,不影响$_GET
?>

③ filter_input 安全实践

使用filter_input()可避免直接访问$_GET带来的安全隐患:

过滤器用途示例
FILTER_SANITIZE_STRING移除/编码特殊字符filter_input(INPUT_GET, 'title', FILTER_SANITIZE_STRING)
FILTER_VALIDATE_INT验证整数filter_input(INPUT_GET, 'id', FILTER_VALIDATE_INT)
FILTER_VALIDATE_URL验证URL格式filter_input(INPUT_GET, 'redirect', FILTER_VALIDATE_URL)
FILTER_CALLBACK自定义过滤函数filter_input(INPUT_GET, 'name', FILTER_CALLBACK, ['options' => 'trim'])

④ http_build_query 的数组处理

当参数为数组时,http_build_query()会生成带索引的查询字符串:

<?php
$params = [
    'user' => ['name' => '张三', 'age' => 25],
    'roles' => ['admin', 'editor']
];
echo http_build_query($params);
// 输出:
// user%5Bname%5D=%E5%BC%A0%E4%B8%89&user%5Bage%5D=25&roles%5B0%5D=admin&roles%5B1%5D=editor
// 解码后为:user[name]=张三&user[age]=25&roles[0]=admin&roles[1]=editor
// 使用 & 作为分隔符(HTML中避免转义)
echo http_build_query($params, '', '&');
?>

⑤ 综合对比与选择建议

php 获取url参数的方法选择应遵循以下原则:

  • 常规GET请求 → 使用$_GET(简单高效)
  • 从完整URL提取参数 → 使用parse_url() + parse_str()
  • 构建新URL参数 → 使用http_build_query()
  • 高安全性场景(如用户输入)→ 使用filter_input() + 自定义过滤器
  • 需要原始编码字符串 → 使用$_SERVER['QUERY_STRING']

三、php 获取url参数的安全处理

在php 获取url参数过程中,若未进行安全处理,极易引发XSS、SQL注入、路径遍历等攻击。以下是常见风险与防护策略:

⚠️ XSS攻击防护

当URL参数被直接输出到HTML时,攻击者可注入恶意脚本。例如:
https://example.com?msg=

正确做法:

<?php
// 方法1:使用htmlspecialchars()
echo '提示:' . htmlspecialchars($_GET['msg'], ENT_QUOTES, 'UTF-8');
// 方法2:使用filter_input()
$msg = filter_input(INPUT_GET, 'msg', FILTER_SANITIZE_SPECIAL_CHARS);
echo '提示:' . $msg;
?>

⚠️ SQL注入防护

即使参数来自URL,也需当作不可信输入处理:

<?php
// ❌ 错误:直接拼接
$sql = "SELECT * FROM users WHERE id = " . $_GET['id'];
// ✅ 正确:使用预处理语句(PDO)
$stmt = $pdo->prepare('SELECT * FROM users WHERE id = :id');
$stmt->execute(['id' => $_GET['id']]);
// ✅ 正确:先验证类型
if (filter_var($_GET['id'], FILTER_VALIDATE_INT)) {
    $id = (int)$_GET['id'];
    $stmt = $pdo->prepare('SELECT * FROM users WHERE id = ?');
    $stmt->execute([$id]);
}
?>

⚠️ 路径遍历攻击

当参数用于文件操作时(如?file=../config.php),攻击者可读取敏感文件:

<?php
// 安全处理:限定允许的文件列表
$allowed = ['about.php', 'contact.php', 'terms.php'];
$file = basename($_GET['file']); // 移除路径
if (in_array($file, $allowed)) {
    include $file;
} else {
    http_response_code(404);
    include '404.php';
}
?>

🛡️ 完整安全过滤模板

推荐建立统一的输入过滤函数:

<?php
function sanitize_input($data, $type = 'string') {
    switch($type) {
        case 'int':
            return filter_var($data, FILTER_VALIDATE_INT) ?: 0;
        case 'email':
            return filter_var($data, FILTER_VALIDATE_EMAIL) ?: '';
        case 'url':
            return filter_var($data, FILTER_VALIDATE_URL) ?: '';
        case 'string':
            return htmlspecialchars(strip_tags($data), ENT_QUOTES, 'UTF-8');
        default:
            return $data;
    }
}
// 使用示例
$id    = sanitize_input($_GET['id'] ?? '', 'int');
$email = sanitize_input($_GET['email'] ?? '', 'email');
?>

四、php 获取url参数的高级技巧

掌握以下技巧可显著提升php 获取url参数的效率与健壮性:

〔1〕处理重复参数名

当URL含重复参数(如?tag=php&tag=java),$_GET仅保留最后一个值。正确处理方式:

<?php
// 方法1:使用数组语法(推荐)
// URL: ?tag[]=php&tag[]=java
echo $_GET['tag'][0]; // php
echo $_GET['tag'][1]; // java
// 方法2:手动解析
$query = explode('&', $_SERVER['QUERY_STRING']);
$tags = [];
foreach ($query as $pair) {
    list($key, $val) = explode('=', $pair);
    $key = urldecode($key);
    $val = urldecode($val);
    if ($key === 'tag[]') {
        $tags[] = $val;
    }
}
print_r($tags);
?>

〔2〕深度解析嵌套参数

PHP支持自动解析嵌套参数(如?user[name]=alice&user[age]=25):

<?php
// URL: ?user[name]=alice&user[age]=25&user[skills][]=php&user[skills][]=mysql
print_r($_GET['user']);
// 获取嵌套值的安全方式
$name = $_GET['user']['name'] ?? '游客';
$skills = $_GET['user']['skills'] ?? [];
?>

〔3〕自定义查询解析器(兼容中文)

某些老系统使用GB2312编码,需自定义解析:

<?php
function parse_query_gbk($query) {
    $result = [];
    $pairs = explode('&', $query);
    foreach ($pairs as $pair) {
        if (strpos($pair, '=') === false) continue;
        list($key, $val) = explode('=', $pair, 2);
        $key = rawurldecode($key);
        $val = rawurldecode($val);
        // 假设原始编码为GBK,转为UTF-8
        $key = iconv('GBK', 'UTF-8//IGNORE', $key);
        $val = iconv('GBK', 'UTF-8//IGNORE', $val);
        parse_str($key . '=' . $val, $temp);
        $result = array_merge_recursive($result, $temp);
    }
    return $result;
}
?>

〔4〕构建无损URL重写

结合$_SERVER['REQUEST_URI']和parse_url()实现无损重写:

<?php
// 从重写URL中提取参数
$request = $_SERVER['REQUEST_URI'];
$parts = parse_url($request);
parse_str($parts['query'] ?? '', $query);
$_GET = array_merge($_GET, $query); // 合并到$_GET
// 示例:/user/alice → $_GET['user'] = 'alice'
if (preg_match('#^/user/([^/]+)$#', $request, $m)) {
    $_GET['user'] = $m[1];
}
?>

五、php 获取url参数的实战案例

以下通过三个典型场景展示php 获取url参数的综合应用:

案例1:分页系统参数处理

需求:从URL中安全获取页码和每页数量,防止越界和非法值。

<?php
// URL: ?page=3&limit=20
$page = max(1, (int)(filter_input(INPUT_GET, 'page', FILTER_VALIDATE_INT) ?: 1));
$limit = min(100, max(1, (int)(filter_input(INPUT_GET, 'limit', FILTER_VALIDATE_INT) ?: 20)));
// 生成分页链接(避免重复参数)
$params = $_GET;
$params['page'] = $page;
unset($params['limit']); // 独立处理limit
$query = http_build_query($params);
echo '<a href="?page=' . ($page-1) . '&' . $query . '>上一页</a>';
?>

案例2:API回调参数验证

需求:微信支付回调URL参数需严格验证签名。

<?php
// 获取原始POST数据(非$_POST,因微信使用application/xml)
$raw = file_get_contents('php://input');
libxml_disable_entity_loader(true);
$xml = simplexml_load_string($raw, 'SimpleXMLElement', LIBXML_NOCDATA);
$data = json_decode(json_encode($xml), true);
// 验证签名(简化版)
if (!verify_sign($data)) {
    http_response_code(403);
    exit('签名验证失败');
}
// 安全使用参数
$transaction_id = filter_var($data['transaction_id'], FILTER_SANITIZE_STRING);
$total_fee = filter_var($data['total_fee'], FILTER_VALIDATE_INT);
?>

案例3:SPA应用路由参数解析

需求:前端路由/post/123?from=home需后端提取ID和来源参数。

<?php
// 伪静态路由解析
$request = ltrim(parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH), '/');
$segments = explode('/', $request);
if ($segments[0] === 'post' && isset($segments[1])) {
    $post_id = filter_var($segments[1], FILTER_VALIDATE_INT);
    if ($post_id) {
        // 同时获取URL参数
        $from = filter_input(INPUT_GET, 'from', FILTER_SANITIZE_STRING);
        $view = new PostView($post_id, $from);
        $view->render();
    }
}
?>