首页 WordPress函数大全 add_query_arg()

add_query_arg()

2020-05-01 / 3971阅 / 悠然

如何你看完本文还不知道如何使用该函数,可以联系我定制视频教程,50元/个函数,学不会全额退款

add_query_arg( $args )

Retrieves a modified URL query string.

描述

You can rebuild the URL and append query variables to the URL query by using this function. There are two ways to use this function; either a single key and value, or an associative array.

Using a single key and value:

add_query_arg( 'key', 'value', 'http://example.com' ); 

Using an associative array:

add_query_arg( array(
    'key1' => 'value1',
    'key2' => 'value2',
), 'http://example.com' ); 

Omitting the URL from either use results in the current URL being used (the value of $_SERVER['REQUEST_URI']).

Values are expected to be encoded appropriately with urlencode() or rawurlencode().

Setting any query variable’s value to boolean false removes the key (see remove_query_arg()).

Important: The return value of add_query_arg() is not escaped by default. Output should be late-escaped with esc_url() or similar to help prevent vulnerability to cross-site scripting (XSS) attacks.

参数

$key

(string|array)
(Required)
Either a query variable key, or an associative array of query variables.

$value

(string)
(Optional)
Either a query variable value, or a URL to act upon.

$url

(string)
(Optional)
A URL to act upon.

返回

(string) New URL query string (unescaped).

大家谈论
    我的见解