查詢字符串指的是鏈接中后邊的問號(hào)后的查詢語句，格式為 key=value，多個(gè)查詢語句用 & 符號(hào)分開。add_query_arg() 函數(shù)就是 WordPress 提供的一個(gè)方便的函數(shù)，可以幫你給一個(gè)鏈接添加一個(gè)或者多個(gè)查詢語句。
有人會(huì)問，添加查詢字符串直接在鏈接后邊手動(dòng)追加不就可以了嗎？這樣有時(shí)候可行，但鏈接如果本身就有查詢字符串就會(huì)造成格式錯(cuò)誤的問題，而且也不利于 PHP 編寫管理，而 add_query_arg() 函數(shù)幫你把一切都想好了，你只需要給出要添加查詢字符串的鏈接和一個(gè)或多個(gè)鍵值與鍵名即可。
用法
|
1
|
|
2
|
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ù)組）（必須）要添加的查詢，鍵值和鍵名分別對應(yīng)。
默認(rèn)值：None
$old_query_or_uri
（字符串）（可選）被處理的鏈接。
默認(rèn)值：False，寫 False 則為 $_SERVER['REQUEST_URI']
返回值
（字符串）添加好查詢字符串的鏈接。
例子
第一種用法：
|
1
|
|
|
echo add_query_arg( 'id', 123, 'http://www.ythuaji.com.cn' ); |
第二種用法：
|
1
|
|
|
echo add_query_arg( array( 'id' => 123 ), 'http://www.ythuaji.com.cn' ); |
兩個(gè)的結(jié)果都是 http://www.ythuaji.com.cn?id=123
其它特殊情況：
|
1
|
|
2
3
|
echo add_query_arg( array( 'id' => 123 ), 'http://www.ythuaji.com.cn/article/108844.html' );//http://www.ythuaji.com.cn/bc/echo add_query_arg( array( 'id' => 123, 'cat' => 'themes' ), 'http://www.ythuaji.com.cn/bc/' );//http://www.ythuaji.com.cn/bc/echo add_query_arg( array( 'id' => 123, 'cat' => 'themes', 'query' => 'page' ), 'http://www.ythuaji.com.cn/bc/' );//http://www.ythuaji.com.cn/bc/ |
例子
此函數(shù)位于：wp-includes/functions.php
