_get_component_from_parsed_url_array()WP 4.7.0

Retrieve a specific component from a parsed URL array.

This is an internal function for using it by WP core itself. It's not recommended to use this function in your code.

No Hooks.


Mixed. False on parse failure; Array of URL components on success; When a specific component has been requested: null if the component doesn't exist in the given URL; a string or - in the case of PHP_URL_PORT - integer when it does. See parse_url()'s return values.


_get_component_from_parsed_url_array( $url_parts, $component );
$url_parts(array|false) (required)
The parsed URL. Can be false if the URL failed to parse.
The specific component to retrieve. Use one of the PHP predefined constants to specify which one.
Default: -1 (= return all parts as an array)


Since 4.7.0 Introduced.

_get_component_from_parsed_url_array() code WP 6.1.1

function _get_component_from_parsed_url_array( $url_parts, $component = -1 ) {
	if ( -1 === $component ) {
		return $url_parts;

	$key = _wp_translate_php_url_constant_to_key( $component );
	if ( false !== $key && is_array( $url_parts ) && isset( $url_parts[ $key ] ) ) {
		return $url_parts[ $key ];
	} else {
		return null;