add_query_arg 添加自定义查询参数生成新的 URL

1. 什么是add_query_arg

add_query_arg是一个 WordPress 函数,用于在现有 URL 上添加自定义查询参数并生成新的 URL。

2. add_query_arg 的语法

add_query_arg 函数的语法如下:

add_query_arg( $param, $value, $url );
  • $param - 要添加的查询参数的名称(字符串)。
  • $value - 要添加的查询参数的值(字符串或整数)。
  • $url - 可选,要添加查询参数的 URL。如果未指定,默认为当前 URL。

3. 如何使用 add_query_arg

以下是一个示例,展示如何使用 add_query_arg 来生成一个包含自定义查询参数的网址:

// 获取当前网址
$current_url = home_url( add_query_arg( null, null ) );

// 添加自定义查询参数
$new_url = add_query_arg( array(
    'custom_param' => 'custom_value',
), $current_url );

// 输出生成的新网址
echo $new_url;

这将输出一个新的 URL,其中包含自定义查询参数 'custom_param'。如果页面的当前 URL 为 http://example.com/post/,那么新的 URL 将在其末尾添加参数,变为 http://example.com/post/?custom_param=custom_value。

4. 注意事项

在使用 add_query_arg 函数时,需要注意以下几点:

  1. 查询参数名称应该是字符串,查询参数值可以是字符串或数字。
  2. 如果未指定 $url,则默认使用当前网址。
  3. 如果要指定多个查询参数,可以将它们作为关联数组传递。
  4. 如果要在 URL 中保留已有查询参数,则不需要添加它们。如果存在同名的查询参数,则新的值将替换旧的值。
晓白博客网版权所有,原文地址https://www.xbnb.cn/4937
© 版权声明
THE END
喜欢就支持一下吧
点赞0 分享
评论 抢沙发

请登录后发表评论

    请登录后查看评论内容