_get_component_from_parsed_url_array( array|false $url_parts, int $component = -1 ): mixed

Parameters

$url_partsarray|false

The parsed URL. Can be false if the URL failed to parse.

$componentintoptional

The specific component to retrieve. Use one of the PHP predefined constants to specify which one. Defaults to -1 (= return all parts as an array).Default: -1

Return

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.

Uses · 1

• _wp_translate_php_url_constant_to_key()Translates a PHP_URL_* constant to the named array keys PHP uses.

Used by · 1

• wp_parse_url()A wrapper for PHP's parse_url() function that handles consistency in the return values across PHP versions.

Source

View on Trac ↗View on GitHub ↗

838function _get_component_from_parsed_url_array( $url_parts, $component = -1 ) {839	if ( -1 === $component ) {840		return $url_parts;841	}842 843	$key = _wp_translate_php_url_constant_to_key( $component );844	if ( false !== $key && is_array( $url_parts ) && isset( $url_parts[ $key ] ) ) {845		return $url_parts[ $key ];846	} else {847		return null;848	}849}

History

Introduced in 4.7.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.0.4 tag, from src/wp-includes/http.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.