_http_build_query

函数
_http_build_query ( $data, $prefix = null, $sep = null, $key = '', $urlencode = true )
Access
Private
参数
  • (array|object) $data An array or object of data. Converted to array.
    Required:
  • (string) $prefix Optional. Numeric index. If set, start parameter numbering with it. Default null.
    Required:
    Default: null
  • (string) $sep Optional. Argument separator; defaults to 'arg_separator.output'. Default null.
    Required:
    Default: null
  • (string) $key Optional. Used to prefix key name. Default empty.
    Required:
    Default: (empty)
  • (bool) $urlencode Optional. Whether to use urlencode() in the result. Default true.
    Required:
    Default: true
返回值
  • (string) The query string.
相关
  • https://www.php.net/manual/en/function.http-build-query.php
定义位置
相关方法
build_query_wp_filter_build_unique_idwp_http_validate_url_wp_upload_dirwp_reset_query
引入
3.2.0
弃用
-

http_build_query是一个PHP函数,在WordPress中也可用。它接收一个数据数组,并从中建立一个URL编码的查询字符串,适合在URL中使用: 这个函数有几个选项,可以用来控制编码的行为,例如指定字段之间的分隔符,控制是否包括空值的字段,等等。在WordPress中,这个函数通常用于为外部API的请求建立URL,或者用于在网站内构建链接。

来自php.net(由Mark Jaquith修改,使其行为类似于本地的PHP5函数)。

function _http_build_query( $data, $prefix = null, $sep = null, $key = '', $urlencode = true ) {
	$ret = array();

	foreach ( (array) $data as $k => $v ) {
		if ( $urlencode ) {
			$k = urlencode( $k );
		}
		if ( is_int( $k ) && null != $prefix ) {
			$k = $prefix . $k;
		}
		if ( ! empty( $key ) ) {
			$k = $key . '%5B' . $k . '%5D';
		}
		if ( null === $v ) {
			continue;
		} elseif ( false === $v ) {
			$v = '0';
		}

		if ( is_array( $v ) || is_object( $v ) ) {
			array_push( $ret, _http_build_query( $v, '', $sep, $k, $urlencode ) );
		} elseif ( $urlencode ) {
			array_push( $ret, $k . '=' . urlencode( $v ) );
		} else {
			array_push( $ret, $k . '=' . $v );
		}
	}

	if ( null === $sep ) {
		$sep = ini_get( 'arg_separator.output' );
	}

	return implode( $sep, $ret );
}

常见问题

FAQs
查看更多 >