這篇文章主要介紹了WordPress中用于合成數(shù)組的wp_parse_args()函數(shù),轉(zhuǎn)換成數(shù)組通常是為了方便查詢,需要的朋友可以參考下。

wp_parse_args() 函數(shù)是 WordPress 核心經(jīng)常用到的函數(shù)，它的用途很多，但最主要用來(lái)給一個(gè)數(shù)組參數(shù)（args）綁定默認(rèn)值。

因?yàn)?wp_parse_args() 函數(shù)返回的一定是一個(gè)數(shù)組，所以他會(huì)把傳入查詢字符串和對(duì)象（object）自動(dòng)轉(zhuǎn)換成數(shù)組，給了使用者更加方便的條件，也增加了兼容性。

常見的 query_posts()、wp_list_comments() 和 get_terms() 函數(shù)都使用了 wp_parse_args() 函數(shù)來(lái)幫它給數(shù)組參數(shù)添加默認(rèn)值。

用法：

wp_parse_args( $args, $defaults );

參數(shù)

$args

（數(shù)組 | 字符串）（必須）查詢字符串、對(duì)象或者數(shù)組參數(shù)，用來(lái)綁定默認(rèn)值。

默認(rèn)值：None

查詢字符串：

type=post&posts_per_page=5&cat=1

數(shù)組：

array( 'type' => 'post', 'posts_per_page' => 5, 'cat' => '1' )

$defaults

（數(shù)組）（可選）數(shù)組參數(shù)的默認(rèn)參數(shù)。

默認(rèn)值：空字符串

例子：

1. function explain_parse_args( $args = array() ){ 
2.    
3.   //$args 的默認(rèn)值 
4.   $defaults = array( 
5.     'before' => '<div class="box">', 
6.     'after' => '</div>', 
7.     'echo' => true, 
8.     'text' => 'wp_parse_args() 函數(shù)演示' 
9.   ); 
10.    
11.   //綁定默認(rèn)值 
12.   $r = wp_parse_args( $args, $defaults ); 
13.    
14.   $output = $r['before'] . $r['text'] . $r['after']; 
15.   if( !$r['echo'] ) return $output; 
16.   echo $output; 
17. } 
18.    
19. //沒(méi)有參數(shù) 
20. explain_parse_args();//打印：<div class="box">wp_parse_args() 函數(shù)演示</div> 
21.    
22. //字符串參數(shù) 
23. $output = explain_parse_args( 'text=字符串參數(shù)&before=<div class="box-2">&echo=0' ); 
24. echo $output;//打印：<div class="box-2">字符串參數(shù)</div> 
25.    
26. //數(shù)組參數(shù) 
27. explain_parse_args( array( 'text' => '數(shù)組參數(shù)', 'before' => '<div class="box-3">' ) );//打印：<div class="box-3">數(shù)組參數(shù)</div> 

還有另一種不使用第二個(gè) $defaults 參數(shù)的用法，就是幫你把一個(gè)查詢字符串、對(duì)象或者數(shù)組的變量直接轉(zhuǎn)換成通用的數(shù)組，避免判斷類型。

1. //字符串 
2. $array = wp_parse_args( 'text=測(cè)試另一種用法&type=字符串' ); 
3. var_dump( $array ); 
4. /* 
5.   array(2) { 
6.     ["text"]=> 
7.       string(21) "測(cè)試另一種用法" 
8.     ["type"]=> 
9.       string(9) "字符串" 
10.   } 
11. */ 
12.    
13. //對(duì)象（object） 
14. class args_obj{ 
15.    
16.   public $text = '測(cè)試另一種用法'; 
17.    
18.   public $type = '對(duì)象（object）'; 
19.    
20.   function func(){ 
21.     //轉(zhuǎn)換成數(shù)組的時(shí)候?qū)ο罄镞叺暮瘮?shù)會(huì)被忽略 
22.   } 
23.    
24. } 
25. $obj = new args_obj; 
26. var_dump( $obj ); 
27. /* 
28. object(args_obj)#2175 (2) { 
29.   ["text"]=> 
30.     string(21) "測(cè)試另一種用法" 
31.   ["type"]=> 
32.     string(18) "對(duì)象（object）" 
33. } 
34. */ 

wp_parse_args函數(shù)源代碼詳解

wp_parse_args 函數(shù)的源代碼比較簡(jiǎn)單，依附于PHP 內(nèi)置函數(shù)get_object_vars、array_merge與WordPress的wp_parse_str函數(shù)來(lái)實(shí)現(xiàn)，以下是該函數(shù)的源代碼：

1. /** 
2.  * Merge user defined arguments into defaults array. 
3.  * 
4.  * This function is used throughout WordPress to allow for both string or array 
5.  * to be merged into another array. 
6.  * 
7.  * @since 2.2.0 
8.  * 
9.  *第一個(gè)參數(shù)可以是 字符串、數(shù)組或?qū)ο螅╫bj） 
10.  * @param string|array $args Value to merge with $defaults 
11.  *第二個(gè)參數(shù)為默認(rèn)的預(yù)設(shè)值數(shù)組，必須是數(shù)組 
12.  * @param array $defaults Array that serves as the defaults. 
13.  *返回值將是一個(gè)數(shù)組 
14.  * @return array Merged user defined values with defaults. 
15.  */ 
16. function wp_parse_args( $args, $defaults = '' ) { 
17.  if ( is_object( $args ) ) 
18.  //將接收的對(duì)象（obj）轉(zhuǎn)換為數(shù)組 
19.  $r = get_object_vars( $args ); 
20.  elseif ( is_array( $args ) ) 
21.  //如果是數(shù)組則不轉(zhuǎn)換 
22.  $r =& $args; 
23.  else 
24.  //將接收的字符串轉(zhuǎn)換為數(shù)組 
25.  wp_parse_str( $args, $r ); 
26.  if ( is_array( $defaults ) ) 
27.  return array_merge( $defaults, $r ); 
28.  return $r; 
29. } 

其中g(shù)et_object_vars函數(shù)是用來(lái)返回由對(duì)象屬性組成的關(guān)聯(lián)數(shù)組。

array_merge函數(shù)用是將兩個(gè)或多個(gè)數(shù)組的單元合并起來(lái)，一個(gè)數(shù)組中的值附加在前一個(gè)數(shù)組的后面。返回作為結(jié)果的數(shù)組。