_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–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/_http_build_query