WordPress_php 스킬에서 배열을 합성하는데 사용되는 wp_parse_args() 함수에 대한 자세한 설명

wp_parse_args() 함수는 WordPress의 핵심에서 자주 사용되는 함수이지만, 주로 기본값을 배열 매개변수(args)에 바인딩하는 데 사용됩니다.

wp_parse_args() 함수는 배열을 반환해야 하기 때문에 들어오는 쿼리 문자열과 객체를 자동으로 배열로 변환하여 사용자에게 보다 편리한 조건을 제공하고 호환성을 높입니다.

일반적인 query_posts(), wp_list_comments() 및 get_terms() 함수는 모두 wp_parse_args() 함수를 사용하여 배열 매개변수에 기본값을 추가하는 데 도움을 줍니다.

사용방법

wp_parse_args( $args, $defaults );

매개변수

$args

(배열 | 문자열) (필수) 기본값을 바인딩하기 위해 문자열, 객체 또는 배열 매개변수를 쿼리합니다.

기본값: 없음

쿼리 문자열:

type=post&posts_per_page=5&cat=1

배열:

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

$기본값

(배열) (선택 사항) 배열 매개변수의 기본 매개변수입니다.

기본값: 빈 문자열

예

function explain_parse_args( $args = array() ){
 
  //$args 的默认值
  $defaults = array(
    'before' => '<div class="box">',
    'after' => '</div>',
    'echo' => true,
    'text' => 'wp_parse_args() 函数演示'
  );
 
  //绑定默认值
  $r = wp_parse_args( $args, $defaults );
 
  $output = $r['before'] . $r['text'] . $r['after'];
  if( !$r['echo'] ) return $output;
  echo $output;
}
 
//没有参数
explain_parse_args();//打印：<div class="box">wp_parse_args() 函数演示</div>
 
//字符串参数
$output = explain_parse_args( 'text=字符串参数&before=<div class="box-2">&echo=0' );
echo $output;//打印：<div class="box-2">字符串参数</div>
 
//数组参数
explain_parse_args( array( 'text' => '数组参数', 'before' => '<div class="box-3">' ) );//打印：<div class="box-3">数组参数</div>
还有另一种不使用第二个 $defaults 参数的用法，就是帮你把一个查询字符串、对象或者数组的变量直接转换成通用的数组，避免判断类型。

//字符串
$array = wp_parse_args( 'text=测试另一种用法&type=字符串' );
var_dump( $array );
/*
  array(2) {
    ["text"]=>
      string(21) "测试另一种用法"
    ["type"]=>
      string(9) "字符串"
  }
*/
 
//对象（object）
class args_obj{
 
  public $text = '测试另一种用法';
 
  public $type = '对象（object）';
 
  function func(){
    //转换成数组的时候对象里边的函数会被忽略
  }
 
}
$obj = new args_obj;
var_dump( $obj );
/*
object(args_obj)#2175 (2) {
  ["text"]=>
    string(21) "测试另一种用法"
  ["type"]=>
    string(18) "对象（object）"
}
*/

wp_parse_args 함수의 상세 소스코드
wp_parse_args 함수의 소스 코드는 비교적 간단합니다.
PHP의 내장 함수 get_object_vars, array_merge 및 WordPress의 wp_parse_str 함수에 따라 구현됩니다.
다음은 해당 함수의 소스코드입니다.

/**
 * Merge user defined arguments into defaults array.
 *
 * This function is used throughout WordPress to allow for both string or array
 * to be merged into another array.
 *
 * @since 2.2.0
 *
 *第一个参数可以是 字符串、数组或对象（obj）
 * @param string|array $args Value to merge with $defaults
 *第二个参数为默认的预设值数组，必须是数组
 * @param array $defaults Array that serves as the defaults.
 *返回值将是一个数组
 * @return array Merged user defined values with defaults.
 */
function wp_parse_args( $args, $defaults = '' ) {
 if ( is_object( $args ) )
 //将接收的对象（obj）转换为数组
 $r = get_object_vars( $args );
 elseif ( is_array( $args ) )
 //如果是数组则不转换
 $r =& $args;
 else
 //将接收的字符串转换为数组
 wp_parse_str( $args, $r );
 if ( is_array( $defaults ) )
 return array_merge( $defaults, $r );
 return $r;
}

get_object_vars 함수는 객체 속성으로 구성된 연관 배열을 반환하는 데 사용됩니다.
array_merge 함수는 두 개 이상의 배열의 셀을 병합하는 데 사용됩니다. 한 배열의 값은 이전 배열의 끝에 추가됩니다. 결과 배열을 반환합니다.