add_query_arg()

add_query_arg()函数是Wordpress函数,检索修改后的URL查询字符串。

add_query_arg( $args )

检索修改后的URL查询字符串。
Retrieves a modified URL query string.

说明(Description)

说明

使用此函数可以重新生成URL并将查询变量附加到URL查询。有两种方法可以使用此函数:一个键和值,或者一个关联数组。

使用单个键和值:

添加查询参数

(’key’,’value’,’http://example.com网站’ );

使用关联数组:

添加查询参数

(数组(

‘key1’=>’value1’,

‘key2’=>’value2’,

), ‘http://example.com网站’ );

从任意一个use中省略URL都会导致当前正在使用的URL(值$_SERVER[‘REQUEST_URI’])。

值应使用urlencode()或rawurlencode()进行适当编码。

将任何查询变量的值设置为boolean false将删除键(请参见remove_query_arg())。

重要提示:默认情况下,add_query_arg()的返回值不会转义。输出应使用esc_url()或类似方法进行后期转义,以帮助防止跨站点脚本(XSS)攻击的漏洞。


参数(Parameters)

参数类型必填说明
$key(string | array)必需查询变量键或查询变量的关联数组。
$value(string)可选要么是查询变量值,要么是要执行操作的URL。
$url(string)可选要执行操作的URL。

返回(Return)

(string)新的URL查询string(string)


更新版本源码位置使用被使用
5.3.0wp-includes/functions.php:10811404

笔记(Notes)

假设我们在WordPress的网址上“http://blog.example.com/client/?s=word“…在输出链接之前,请注意使用esc_url()。这是必要的,因为此函数不转义url,如果输出不转义,将使页面易受XSS脚本攻击。
将用户安全重定向到内部的自定义页插件.php
由于get_permalink()返回一个完整的URL,因此当您想向post的页面添加变量时,可以使用它。

个人中心
购物车
优惠劵
今日签到
有新私信 私信列表
搜索