在 WordPress 中，add_query_arg 是一个非常有用的函数，用于构建 URL 查询参数字符串。该函数可以帮助您动态地向 URL 中添加、更新或删除查询参数，使得您可以轻松地操作 URL，并生成新的 URL 字符串。

语法

add_query_arg( $args, $url );

• $args（必选）：一个数组或字符串，包含要添加到 URL 查询参数。
• $url（可选）：原始 URL 字符串，如果省略，则默认为当前页面的 URL。

功能

add_query_arg 函数的主要功能是将查询参数添加到 URL 中，并返回新的 URL 字符串。它接受一个键值对数组或一个包含查询参数的字符串作为参数，然后根据wordpress插件参数构建新的 URL。

示例用法

使用数组添加查询参数

$current_url = "http://example.com/page/";
$args = array(
    'param1' => 'value1',
    'param2' => 'value2'
);
$new_url = add_query_arg( $args, $current_url );
// 输出结果：http://example.com/page/?param1=value1&param2=value2

使用字符串添加查询参数

$current_url = "http://example.com/page/";
$new_url = add_query_arg( 'param3=value3', $current_url );
// 输出结果：http://example.com/page/?param3=value3

添加查询参数到当前页面

$current_url = add_query_arg( 'param4=value4' );
// 如果当前页面 URL 为 http://example.com/page/, 则输出结果为：http://example.com/page/?param4=value4

注意事项

• add_query_arg 函数不会修改原始 URL，而是返回一个新的 URL 字符串。
• 当添加查询参数时，请确保参数的格式正确，以避免可能的 URL 错误。
• 要注意 URL 编码，特别是当参数值包含特殊字符时，应使用 urlencode 函数进行编码。

通过灵活使用 add_query_arg 函数，您可以方便地处理 URL 查询参数，实现动态生成 URL 的需求，提升 WordPress 网站的功能和交互性。