<p>应使用 parse_url 拆解 URL，修改 query 部分后用 http_build_query 重建，再拼接 fragment；直接 preg_replace 易误删锚点，因未隔离 # 后内容。</p>
PHP正则替换URL时锚点被意外清除
直接用 preg_replace 替换查询参数，却把 #section1 这类锚点一起干掉了——根本原因是正则没做锚点隔离，匹配范围越过了 ? 或 & 直接吞掉后面所有内容。
用 (?#[^#]*$) 显式捕获并保留锚点
锚点永远在 URL 最末，且只出现一次，所以最稳的方式是：先分离锚点，处理完 query 再拼回去。但若坚持单次正则，必须让锚点成为“不参与替换的独立后缀”：
- 匹配模式应为：
/([?&])key=[^&\#]*(?=&|\#|$)/——\#加入分隔符集合，防止跨过# - 替换时用
$1newval，再手动补上原锚点（需提前用parse_url($url, PHP_URL_FRAGMENT)提取） - 更稳妥的做法：先用
parse_url拆解，改query部分，再用http_build_query重建，最后拼fragment
http_build_query 重建 query 更安全，但要注意编码
手拼 query 字符串极易出错，比如中文变乱码、& 被当分隔符。用 http_build_query 是标准解法，但有两点必须处理：
- 原始
query要先parse_str($query, $arr)解析成数组，再修改键值，避免遗漏或覆盖 - 如果原 URL 的参数值含 URL 编码（如
q=%E4%BD%A0%E5%A5%BD），parse_str会自动解码，而http_build_query默认再编码 —— 若需保持原编码形式，得先rawurlencode手动处理 - 别忘了：
parse_url返回的query是字符串，fragment是字符串，二者都为空时不能拼出?或#
完整可复用的函数片段
以下函数能安全替换任意参数并保留锚点，已处理空 fragment、无 query、特殊字符等边界情况：
立即学习“PHP免费学习笔记（深入）”；
function replaceUrlParam($url, $key, $value) {
$parts = parse_url($url);
parse_str($parts['query'] ?? '', $query);
$query[$key] = $value;
$parts['query'] = http_build_query($query);
$newUrl = $parts['scheme'] . '://' . $parts['host'] . ($parts['port'] ? ':' . $parts['port'] : '') . $parts['path'];
if ($parts['query']) $newUrl .= '?' . $parts['query'];
if ($parts['fragment'] !== null) $newUrl .= '#' . $parts['fragment'];
return $newUrl;
}
真正容易被忽略的是：当原始 URL 带端口、带用户信息（user:pass@）、或路径含 %2F 时，parse_url 输出结构会变化，上面函数只覆盖了常见 HTTP 场景。生产环境若需 100% 兼容，得额外判断 $parts['user']、$parts['pass'] 和 $parts['path'] 是否需要 rawurldecode。
