查詢字符串指的是鏈接中后邊的問號(hào)后的查詢語句，格式為 key=value，多個(gè)查詢語句用 & 符號(hào)分開。add_query_arg() 函數(shù)就是 WordPress 提供的一個(gè)方便的函數(shù)，可以幫你給一個(gè)鏈接添加一個(gè)或者多個(gè)查詢語句。

20151218154909432.png (958×120)

有人會(huì)問，添加查詢字符串直接在鏈接后邊手動(dòng)追加不就可以了嗎？這樣有時(shí)候可行，但鏈接如果本身就有查詢字符串就會(huì)造成格式錯(cuò)誤的問題，而且也不利于 PHP 編寫管理，而 add_query_arg() 函數(shù)幫你把一切都想好了，你只需要給出要添加查詢字符串的鏈接和一個(gè)或多個(gè)鍵值與鍵名即可。

用法

add_query_arg( $key, $value, $old_query_or_uri );
add_query_arg( $query, $old_query_or_uri );

參數(shù)

add_query_arg() 有兩種用法，第一種用法需要三個(gè)參數(shù)。

$key

（整數(shù) | 字符串）（必須）要添加的參數(shù)的鍵值，像數(shù)組一樣，如果是字符串則為名字，數(shù)字則選擇第 N 個(gè)參數(shù)。

默認(rèn)值：None

$value

（混合）（必須）要添加的值。

默認(rèn)值：None

$old_query_or_uri

（字符串）（可選）被處理的鏈接。

默認(rèn)值：False，寫 False 則為 $_SERVER['REQUEST_URI']

第二種用法需要兩個(gè)參數(shù)，用數(shù)組傳遞要被添加到鏈接上的查詢字符串。

$query

（數(shù)組）（必須）要添加的查詢，鍵值和鍵名分別對(duì)應(yīng)。

默認(rèn)值：None

$old_query_or_uri

（字符串）（可選）被處理的鏈接。

默認(rèn)值：False，寫 False 則為 $_SERVER['REQUEST_URI']

返回值

（字符串）添加好查詢字符串的鏈接。

例子

第一種用法：

echo add_query_arg( 'id', 123, 'http://www.dbjr.com.cn' );

第二種用法：

echo add_query_arg( array( 'id' => 123 ), 'http://www.dbjr.com.cn' );

兩個(gè)的結(jié)果都是 http://www.dbjr.com.cn?id=123

其它特殊情況：

echo add_query_arg( array( 'id' => 123 ), 'http://www.dbjr.com.cn?query=post' );//http://www.dbjr.com.cn?query=post&id=123
echo add_query_arg( array( 'id' => 123, 'cat' => 'themes' ), 'http://www.dbjr.com.cn?query=post' );//http://www.dbjr.com.cn?query=post&id=123&cat=themes
echo add_query_arg( array( 'id' => 123, 'cat' => 'themes', 'query' => 'page' ), 'http://www.dbjr.com.cn?query=post' );//http://www.dbjr.com.cn?query=page&id=123&cat=themes

例子

此函數(shù)位于：wp-includes/functions.php

您可能感興趣的文章: