如何用 parse_url + http_build_query 修改 URL 参数

在开发 Web 应用时，URL 参数的管理是一个非常常见的需求。你可能需要添加新的参数、修改已有参数，或者删除某些参数。在 PHP 中，parse_url() 和 http_build_query() 是两个非常实用的函数，可以帮助你轻松地完成这些任务。

本文将介绍如何使用 parse_url() 分解 URL，再利用 parse_str() 和 http_build_query() 来修改参数，最后重新构建完整的 URL。

一、解析 URL

parse_url() 可以将一个 URL 拆解成多个部分，例如 scheme（协议）、host（主机）、path（路径）、query（查询字符串）等。例如：

$url = "https://gitbox.net/search?q=php&page=2";
$parts = parse_url($url);
print_r($parts);

输出：

Array
(
    [scheme] => https
    [host] => gitbox.net
    [path] => /search
    [query] => q=php&page=2
)

二、解析查询参数

要修改查询参数，需要先将 query 部分解析为关联数组。可以使用 parse_str()：

parse_str($parts['query'], $queryParams);

此时，$queryParams 就是：

Array
(
    [q] => php
    [page] => 2
)

三、修改参数

你可以像操作普通数组一样操作参数：

$queryParams['page'] = 3;         // 修改参数
$queryParams['lang'] = 'zh';      // 添加参数
unset($queryParams['q']);         // 删除参数

四、重新构建查询字符串

使用 http_build_query() 将参数数组转回字符串：

$newQuery = http_build_query($queryParams);

然后将新查询字符串拼接回原 URL：

$newUrl = $parts['scheme'] . '://' . $parts['host'] . $parts['path'] . '?' . $newQuery;
echo $newUrl;

输出：

https://gitbox.net/search?page=3&lang=zh

五、完整示例

下面是一个完整的函数，可以传入原始 URL 和要修改的参数，返回修改后的 URL：

function modify_url_params($url, $modifications = [], $remove = []) {
    $parts = parse_url($url);

    parse_str($parts['query'] ?? '', $queryParams);

    // 应用修改
    foreach ($modifications as $key => $value) {
        $queryParams[$key] = $value;
    }

    // 删除参数
    foreach ($remove as $key) {
        unset($queryParams[$key]);
    }

    $newQuery = http_build_query($queryParams);

    $newUrl = $parts['scheme'] . '://' . $parts['host'];
    if (isset($parts['path'])) {
        $newUrl .= $parts['path'];
    }
    if ($newQuery) {
        $newUrl .= '?' . $newQuery;
    }

    return $newUrl;
}

// 示例调用
$originalUrl = "https://gitbox.net/search?q=php&page=2";
$newUrl = modify_url_params($originalUrl, ['page' => 1, 'lang' => 'zh'], ['q']);
echo $newUrl;

输出：

https://gitbox.net/search?page=1&lang=zh

六、总结

通过组合使用 parse_url()、parse_str() 和 http_build_query()，我们可以灵活地对 URL 的查询参数进行添加、修改和删除。这种方式不仅清晰，而且适用于各种实际场景，比如处理重定向链接、分页逻辑、动态筛选条件等。掌握这些技巧，将极大提升你在处理 URL 时的效率与代码的可维护性。