函數(shù)功能描述

給一個 URL 添加新的查詢參數(shù)獲取新的 URL。

我們可以使用此功能重建URL，或添加新的查詢參數(shù)到URL，也可以獲取帶查詢參數(shù)的完整URL。

添加一個鍵值對或者一個關(guān)聯(lián)數(shù)組，設(shè)置鍵的值為假可以出URL移除該查詢字符串。用 $_SERVER 值省略舊的查詢或 URI（第二或第三個參數(shù)）。

使用說明

//?參數(shù)為單獨的字符串值
add_query_arg(?$param1,?$param2,?$old_query_or_uri?);

//?參數(shù)為 鍵 =>?值對 數(shù)組
add_query_arg(?array('key1'?=>?'value1',?...),?$old_query_or_uri?);

參數(shù)

返回值

新的URL查詢字符串。

使用示例

假設(shè)我們當(dāng)前在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 );

很多時候你可能發(fā)現(xiàn)你想使用下面的方法在你所在的當(dāng)前頁面添加查詢參數(shù)，這中情況下，你可以使用你需要修改的URL作為最后一個參數(shù)。

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

因為 get_permalink() 函數(shù)返回的是一個完整的URL，在需要修改文章頁面時，你可以使用這個函數(shù)作為最后一個參數(shù)。

// 下面將輸出添加查詢字符串：?hello=there 后的 id 為 9 的文章的鏈接。
echo add_query_arg( 'hello', 'there', get_permalink(9) );

通過關(guān)聯(lián)數(shù)組刪除和添加查詢字符串：

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

相關(guān)函數(shù)

remove_query_arg