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