1. 首页
  2. WordPress 函数手册

add_query_arg()

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)


源码(Source)


更新版本 源码位置 使用 被使用
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的页面添加变量时,可以使用它。

add_query_arg() 为WP2原创文章,链接:https://www.wp2.cn/functions/add_query_arg/

发表评论

您的电子邮箱地址不会被公开。