本文介绍使用 PHP 内置函数（如 parse_url、parse_str 和 http_build_query）动态修改 URL 中指定 GET 参数（如 page）的值，适用于分页链接生成等场景，避免正则表达式带来的解析风险。
本文介绍使用 php 内置函数（如 `parse_url`、`parse_str` 和 `http_build_query`）动态修改 url 中指定 get 参数（如 `page`）的值，适用于分页链接生成等场景，避免正则表达式带来的解析风险。
在构建分页导航、筛选链接或 SEO 友好的动态 URL 时，经常需要保留当前请求的所有 GET 参数，仅更新其中某一项（例如 page=2 → page=3）。虽然有人尝试用正则表达式直接替换，但这种方式极易出错：无法正确处理 URL 编码、参数顺序变化、重复键、空值或缺失查询字符串等情况。
推荐采用 URL 解析—修改—重建 的标准流程，完全依赖 PHP 原生函数，安全、健壮且语义清晰：
✅ 正确做法：结构化解析与重建
// 获取当前完整 URL（含协议、主机、路径和查询字符串）
$current_url = (isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] === 'on' ? 'https' : 'http')
. '://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];
// 步骤 1：解析 URL 结构
$parts = parse_url($current_url);
if (!isset($parts['query']) || $parts['query'] === '') {
$parts['query'] = ''; // 确保 query 键存在
}
// 步骤 2：将查询字符串解析为关联数组
parse_str($parts['query'], $params);
// 步骤 3：安全修改目标参数（自动处理编码/空值）
$params['page'] = (int)$next_page_number; // 例如：3，强制整型更安全
// 步骤 4：重新生成标准化查询字符串（自动编码特殊字符）
$new_query = http_build_query($params);
// 步骤 5：组装新 URL（注意：仅替换 query 部分，保留 fragment 等）
$new_url = $parts['scheme'] . '://' . $parts['host'] . $parts['path']
. (!empty($new_query) ? '?' . $new_query : '')
. (isset($parts['fragment']) ? '#' . $parts['fragment'] : '');? 关键优势说明
- 自动编码处理：http_build_query() 会正确对 &, =, 空格、中文等进行 URL 编码，避免手动拼接导致的乱码或注入风险；
- 兼容边界情况：支持无查询参数（? 不存在）、带锚点（#section）、多值同名参数（需配合 parse_str 的数组语法）；
- 类型安全：可对新值做显式类型转换（如 (int) 或 filter_var($val, FILTER_SANITIZE_NUMBER_INT)），防止恶意输入；
- 零正则依赖：规避 preg_replace 在复杂 URL 下匹配失败、过度替换或破坏编码的风险。
⚠️ 注意事项
- 若原始 URL 含有 #hash 片段，parse_url() 默认提取 fragment，务必在重建时一并拼接，否则丢失锚点；
- parse_str() 不区分 page=1 和 page[]=1；如需支持数组型参数（如 filter[]=a&filter[]=b），应确保 $params 中对应键为数组，并使用 http_build_query($params, '', '&', PHP_QUERY_RFC3986)；
- 生产环境建议封装为可复用函数，例如：
function replaceQueryParam(string $url, string $key, $value): string {
$parts = parse_url($url);
parse_str($parts['query'] ?? '', $params);
$params[$key] = $value;
$parts['query'] = http_build_query($params);
return implode('', [
$parts['scheme'] . '://' . $parts['host'] . $parts['path'],
!empty($parts['query']) ? '?' . $parts['query'] : '',
$parts['fragment'] ?? ''
]);
}
// 使用示例
$next_link = replaceQueryParam($current_url, 'page', 5);
echo '<a href="' . htmlspecialchars($next_link) . '">第 5 页</a>';始终对输出到 HTML 的 URL 进行 htmlspecialchars() 转义，防止 XSS —— 即使 URL 本身合法，也不能跳过前端安全防护。
