W3cubDocs

/WordPress

_http_build_query( array|object $data, string $prefix = null, string $sep = null, string $key = '', bool $urlencode = true )

This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness. Use https://www.php.net/manual/en/function.http-build-query.php instead.

From php.net (modified by Mark Jaquith to behave like the native PHP5 function).

Description

See also

Parameters

$data

(array|object) (Required) An array or object of data. Converted to array.

$prefix

(string) (Optional) Numeric index. If set, start parameter numbering with it.

Default value: null

$sep

(string) (Optional) Argument separator; defaults to 'arg_separator.output'.

Default value: null

$key

(string) (Optional) Used to prefix key name.

Default value: ''

$urlencode

(bool) (Optional) Whether to use urlencode() in the result.

Default value: true

Return

(string) The query string.

Source

File: wp-includes/functions.php

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 );
}

Changelog

Version Description
3.2.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/_http_build_query