在PHP开发中,参数获取是构建动态Web应用的基石。无论是处理用户提交的表单、解析API请求、还是进行URL路由匹配,掌握php 获取参数的完整知识体系都至关重要。本页面系统梳理PHP中各类参数来源的获取方式、安全风险、最佳实践与典型场景,覆盖从基础语法到高级技巧的全维度内容。
PHP作为服务端脚本语言,通过一组预定义的超全局变量(superglobals)提供对客户端请求数据的统一访问接口。这些变量包括$_GET、$_POST、$_REQUEST、$_SERVER、$_COOKIE、$_FILES和$_SESSION等。其中,php 获取参数最常涉及前四个,它们分别对应HTTP协议不同层面的请求数据。
值得注意的是,自PHP 5.3起,$_REQUEST的默认顺序为G(GET)→P(POST)→C(COOKIE),这意味着若同一键名在多个来源中存在,COOKIE值会覆盖POST,而POST会覆盖GET——这一默认行为常被忽略却引发严重安全漏洞。例如攻击者可通过构造?id=1&session_id=evil覆盖服务器设定的会话标识,实现会话固定攻击(Session Fixation)。
根据2025年OWASP Top 10安全风险报告,参数注入类漏洞(如SQL注入、XSS、命令注入)仍占Web安全事件的37%,其中82%源于未正确处理php 获取参数导致。因此,理解参数来源、类型、生命周期及过滤策略,是防御此类攻击的第一道防线。
$_GET['key']等语法读取数据⚠️ 注意:PHP仅自动解析application/x-www-form-urlencoded、multipart/form-data和query string格式的参数;对于application/json或text/xml等格式,必须手动解析。
$_GET是PHP中最基础的参数获取方式,用于读取URL查询字符串中的键值对。其数据通过HTTP GET请求传递,典型形式为:https://example.com/page.php?name=php&version=8.2。此时$_GET['name']值为'php',$_GET['version']为'8.2'。
GET参数具有以下特性:
• 数据可见于URL,适合传递非敏感信息
• 有长度限制(受浏览器与服务器约束,通常2048字符)
• 可被缓存、书签、重放攻击
• 默认自动URL解码(支持中文、特殊符号)
在RESTful API设计中,GET常用于资源查询。例如:GET /api/users?id=1024应返回ID为1024的用户信息。但需注意:若将ID直接拼接进SQL语句,极易引发SQL注入。
<?php
// URL: /search.php?keyword=php获取参数&page=2
$keyword = $_GET['keyword'] ?? '默认搜索'; // 使用NULL合并运算符避免未定义警告
$page = (int)($_GET['page'] ?? 1);
if ($page < 1) $page = 1;
echo "搜索关键词:$keyword,第 $page 页";
?>
💡 技巧:使用filter_input()函数可实现类型安全过滤:
$page = filter_input(INPUT_GET, 'page', FILTER_VALIDATE_INT, ['options' => ['min_range' => 1, 'max_range' => 1000]]);
1. 误认为$_GET仅包含URL中的参数——实际上它也包含表单method="GET"提交的数据
2. 忽略中文编码问题:需确保HTML页面<meta charset="UTF-8">且服务器未启用auto_detect_line_endings
3. 未校验参数存在性:直接访问$_GET['id']可能触发Undefined array key警告
$_GET['id']拼接进SELECT * FROM users WHERE id = $idecho $_GET['msg']导致脚本执行header("Location: " . $_GET['url'])可跳转至恶意站点?token=abc123)$_POST用于接收HTTP POST请求体中的数据,适用于表单提交、API数据上传等场景。与GET不同,POST数据不显示在URL中,但本质上仍属客户端可控输入,不可直接信任。
POST支持多种Content-Type:
• application/x-www-form-urlencoded:默认表单格式,数据类似GET查询字符串
• multipart/form-data:含文件上传的表单,需配合$_FILES处理
• application/json:JSON格式数据,需手动解析(见后文)
<form method="post" action="login.php">
<input name="username" required>
<input type="password" name="password" required>
<button type="submit">登录</button>
</form>
<?php
// login.php
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
$user = htmlspecialchars($_POST['username'] ?? '', ENT_QUOTES, 'UTF-8');
$pass = $_POST['password'] ?? '';
if (strlen($pass) < 8) {
exit('密码长度不足8位');
}
// 使用预处理语句防SQL注入
$stmt = $pdo->prepare("SELECT * FROM users WHERE username = ?");
$stmt->execute([$user]);
}
?>
⚠️ 关键细节:当POST数据为JSON格式时,$_POST将为空!必须通过file_get_contents('php://input')读取原始数据并解析:
<?php
// Content-Type: application/json
$input = file_get_contents('php://input');
$data = json_decode($input, true);
if (json_last_error() !== JSON_ERROR_NONE) {
http_response_code(400);
exit('无效JSON数据');
}
$username = $data['username'] ?? '游客';
?>
1. 未限制文件上传大小:攻击者可上传超大文件耗尽服务器资源
2. 忽略CSRF防护:未验证$_POST请求来源(需配合Token机制)
3. 未校验数组参数:如$_POST['ids']可能为字符串或数组,直接遍历导致类型错误
$_REQUEST是GET、POST、COOKIE的合并数组,其内容顺序由variables_order指令决定(默认为EGPCS)。虽然使用方便,但存在严重安全隐患:
OWASP明确建议:禁止直接使用$_REQUEST,应根据数据来源显式选择$_GET或$_POST。
1. 在php.ini中禁用COOKIE混入:
request_order = "GP"(排除C)
2. 使用自定义函数封装:
function getParam($key) { return $_GET[$key] ?? $_POST[$key] ?? null; }
3. 在框架中统一拦截:
$input = array_merge($_GET, $_POST); // 显式合并
<?php
function safeInput($key, $type = 'both') {
switch ($type) {
case 'get': return $_GET[$key] ?? null;
case 'post': return $_POST[$key] ?? null;
default: return $_GET[$key] ?? $_POST[$key] ?? null;
}
}
// 使用示例
$id = safeInput('id', 'get'); // 仅允许GET参数
?>
$_SERVER包含服务器环境与请求元数据,常用于获取客户端IP、请求方法、User-Agent、HTTP头等。典型用法:
• $_SERVER['REMOTE_ADDR']:客户端真实IP
• $_SERVER['HTTP_X_FORWARDED_FOR']:代理转发IP(可伪造!)
• $_SERVER['REQUEST_METHOD']:请求方式(GET/POST/PUT)
• $_SERVER['HTTP_USER_AGENT']:浏览器标识
⚠️ 注意:$_SERVER['REMOTE_ADDR']在CDN或反向代理环境下可能返回代理服务器IP,需结合HTTP_X_FORWARDED_FOR判断,但后者可被客户端伪造。安全做法是:
1. 仅信任可信代理列表中的X-Forwarded-For
2. 在Nginx层覆盖X-Real-IP头
3. 使用filter_var($_SERVER['REMOTE_ADDR'], FILTER_VALIDATE_IP)校验IP合法性
<?php
function getClientIP() {
$ipKeys = ['HTTP_X_FORWARDED_FOR', 'HTTP_CLIENT_IP', 'REMOTE_ADDR'];
foreach ($ipKeys as $key) {
if (isset($_SERVER[$key])) {
$ip = $_SERVER[$key];
// 处理多IP(取第一个)
$ips = explode(',', $ip);
$ip = trim($ips[0]);
if (filter_var($ip, FILTER_VALIDATE_IP)) {
return $ip;
}
}
}
return '0.0.0.0'; // 回退值
}
?>
• 未校验HTTP_HOST:直接用于重定向可能导致Open Redirect
• 忽略REQUEST_TIME:记录请求时间应使用$_SERVER['REQUEST_TIME_FLOAT'](毫秒精度)
• 误用SCRIPT_FILENAME:路径遍历攻击入口(如?file=../../../etc/passwd)
php 获取参数的安全性直接决定应用健壮性。以下从输入验证、过滤、转义三层面构建完整防护链。
验证确保数据符合预期格式,例如:
• filter_var($email, FILTER_VALIDATE_EMAIL)
• filter_var($ip, FILTER_VALIDATE_IP)
• 正则表达式校验:preg_match('/^[a-zA-Z0-9_]+$/', $username)
过滤清除危险字符:
• filter_var($str, FILTER_SANITIZE_STRING)(PHP 8.1+已移除)
• htmlspecialchars($str, ENT_QUOTES, 'UTF-8')防XSS
• intval($str)强制转整型
• filter_var($str, FILTER_SANITIZE_EMAIL)
filter_input()而非$_GET/$_POST直接访问array_walk_recursive($data, function(&$val) { $val = htmlspecialchars($val, ENT_QUOTES); });根据上下文选择转义方式:
• HTML内容:htmlspecialchars()
• HTML属性:htmlspecialchars($val, ENT_QUOTES, 'UTF-8', false)
• JavaScript:json_encode($val, JSON_HEX_TAG | JSON_HEX_APOS)
• SQL语句:必须使用预处理语句(PDO/MySQLi)
<?php
// filter.php
$_GET = array_map('htmlspecialchars', $_GET);
$_POST = array_map('htmlspecialchars', $_POST);
$_COOKIE = array_map('htmlspecialchars', $_COOKIE);
// 注意:仅过滤非关键数据,数据库字段需单独处理
?>
• 禁止对数据库字段使用addslashes()(应使用预处理语句)
• 禁止将json_encode()用于SQL拼接
• 禁止信任客户端发送的Content-Type头
现代API普遍采用JSON格式传输数据。PHP原生支持JSON解析,但需注意以下细节:
使用json_decode()时必须检查错误:
$data = json_decode(file_get_contents('php://input'), true);
if (json_last_error() !== JSON_ERROR_NONE) {
throw new Exception('JSON解析失败: ' . json_last_error_msg());
}
<?php
header('Content-Type: application/json');
try {
$input = file_get_contents('php://input');
$data = json_decode($input, true, 512, JSON_THROW_ON_ERROR);
// 验证必需字段
if (!isset($data['email']) || !filter_var($data['email'], FILTER_VALIDATE_EMAIL)) {
throw new Exception('无效邮箱');
}
// 安全使用数据
$user = [
'email' => $data['email'],
'created' => date('Y-m-d H:i:s')
];
echo json_encode(['status' => 'success', 'data' => $user]);
} catch (JsonException $e) {
http_response_code(400);
echo json_encode(['error' => 'JSON格式错误']);
} catch (Exception $e) {
http_response_code(400);
echo json_encode(['error' => $e->getMessage()]);
}
?>
使用json_encode()时添加标志防止XSS:
json_encode($data, JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_HEX_AMP)
| 标志 | 作用 |
|---|---|
| JSON_HEX_TAG | 转义<和>为\u003C和\u003E |
| JSON_HEX_APOS | 转义单引号'为\u0027 |
| JSON_HEX_QUOT | 转义双引号"为\u0022 |
| JSON_HEX_AMP | 转义&为\u0026 |
RESTful风格要求URL清晰表达资源层级,参数设计需遵循以下原则:
/users/123中的123/users?page=2&limit=20| 请求 | 说明 |
|---|---|
| GET /users | 获取用户列表 |
| GET /users/123 | 获取ID=123的用户 |
| POST /users | 创建新用户 |
| PUT /users/123 | 更新用户123 |
| DELETE /users/123 | 删除用户123 |
| GET /users?role=admin&status=active | 筛选管理员+活跃用户 |
推荐使用page和limit(非offset),并提供total字段:
/articles?page=2&limit=10 → 返回第2页(10条/页)
<?php
$page = max(1, (int)($_GET['page'] ?? 1));
$limit = min(100, max(1, (int)($_GET['limit'] ?? 20)));
$offset = ($page - 1) * $limit;
// 防止SQL注入:使用预处理语句
$stmt = $pdo->prepare("SELECT * FROM articles LIMIT ? OFFSET ?");
$stmt->execute([$limit, $offset]);
?>
• 在路径中使用动词:如/getUsers(应为/users)
• 混合使用POST和GET:如POST /users?id=123(ID应在路径中)
• 未限制分页数量:攻击者可请求?limit=999999拖库
答:GET通过URL传递参数,数据可见且长度受限;POST通过请求体传递,数据不可见且容量更大。GET适合非敏感数据查询,POST适合表单提交和文件上传。两者均属客户端可控输入,必须统一安全处理。
答:优先使用$_SERVER['REMOTE_ADDR'],但在代理环境下需结合X-Forwarded-For。正确做法是:
① 仅信任可信代理服务器配置的X-Real-IP
② 验证IP合法性:filter_var($ip, FILTER_VALIDATE_IP)
③ 记录原始IP用于审计
答:因PHP仅自动解析application/x-www-form-urlencoded和multipart/form-data格式。处理JSON需用:
$data = json_decode(file_get_contents('php://input'), true);
并检查json_last_error()确保解析成功。
答:因GET/POST/COOKIE参数可能同名冲突,且COOKIE可被客户端注入。例如:
?id=1 + Cookie中id=evil → $_REQUEST['id']值为evil。应显式使用$_GET或$_POST替代。
答:采用三层防御:
① 输入验证:使用filter_var()或正则校验格式
② 输出转义:HTML用htmlspecialchars(),SQL用预处理语句
③ 白名单机制:仅允许预定义参数存在