add query arg 添加自定义查询参数生成新的 URL

评分:
评分 5.00, 满分 5 星
1

函数功能描述

给一个 URL 添加新的查询参数获取新的 URL。

我们可以使用此功能重建URL,或添加新的查询参数到URL,也可以获取带查询参数的完整URL。

添加一个键值对或者一个关联数组,设置键的值为假可以出URL移除该查询字符串。用 $_SERVER 值省略旧的查询或 URI(第二或第三个参数)。

使用说明

<?php
// 参数为单独的字符串值
add_query_arg( $param1, $param2, $old_query_or_uri );

// 参数为 键 => 值对 数组
add_query_arg( array('key1' => 'value1', ...), $old_query_or_uri );
?>

参数

$param1
(integer|string|array) (必要) 新查询字符串或数组
默认:无

$param2
(integer|string|boolean) (可选) 新查询字符串值 (or the old query or the uri if first parameter is an associative array).
默认:无

$old_query_or_uri
(string|boolean) (可选) 旧查询字符串或uri
默认:$_SERVER[REQUEST_URI]

返回值

新的URL查询字符串。

使用示例

假设我们当前在WordPress页面: “http://blog.example.com/client/?s=word”…

// 下面将输出 '/client/?s=word&foo=bar'
echo add_query_arg( 'foo', 'bar' );

// 下面将输出 '/client/?s=word&foo=bar&baz=tiny'
$arr_params = array( 'foo' => 'bar', 'baz' => 'tiny' );
echo add_query_arg( $arr_params );

很多时候你可能发现你想使用下面的方法在你所在的当前页面添加查询参数,这中情况下,你可以使用你需要修改的URL作为最后一个参数。

// 下面将输出 'http://blog.example.com/2009/04/16/?hello=world'
echo add_query_arg( 'hello', 'world', 'http://blog.example.com/2009/04/16/' );

因为 get_permalink() 函数返回的是一个完整的URL,在需要修改文章页面时,你可以使用这个函数作为最后一个参数。

// 下面将输出添加查询字符串:?hello=there 后的 id 为 9 的文章的链接。
echo add_query_arg( 'hello', 'there', get_permalink(9) );

通过关联数组删除和添加查询字符串:

$query = 'http://example.com/link?foo=bar';
$new_query = add_query_arg( array('foo' => false, 'baz' => 'qux'), $query );
// 结果:http://example.com/link?baz=qux

本站提供 WordPress 主题定制开发服务

本站长期承接 WordPress 主题、插件、基于 WooCommerce 的商店商城开发业务。 我们有 8 年 WordPress 开发经验,如果你想 用 WordPress 开发网站, 请联系 QQ: 470266798,或邮箱: 4626395@gmail.com 咨询。

发表评论

电子邮件地址不会被公开。 必填项已用*标注

*