# wp_parse_url()

URL: https://chugunov.pro/api-wordpress/functions/wp_parse_url/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 4.4.0.

## Сигнатура

```php
wp_parse_url( string $url, int $component = -1 ): mixed
```

## Описание

В разных версиях PHP URL без схемы, содержащие «:» в строке запроса, обрабатываются по-разному. Эта функция обходит такие различия.

## Параметры

- `$url` `string` — обязательный. URL для разбора.
- `$component` `int` — необязательный, по умолчанию `-1`. Конкретный компонент, который нужно получить. Укажите нужный с помощью одной из предопределённых констант PHP.
  
  Значение по умолчанию — -1 (то есть вернуть все части в виде массива).

## Возвращаемое значение

`mixed`

## Исходный код

Файл: `wp-includes/http.php:740`

```php
function wp_parse_url( $url, $component = -1 ) {
	$to_unset = array();
	$url      = (string) $url;

	if ( str_starts_with( $url, '//' ) ) {
		$to_unset[] = 'scheme';
		$url        = 'placeholder:' . $url;
	} elseif ( str_starts_with( $url, '/' ) ) {
		$to_unset[] = 'scheme';
		$to_unset[] = 'host';
		$url        = 'placeholder://placeholder' . $url;
	}

	$parts = parse_url( $url );

	if ( false === $parts ) {
		// Parsing failure.
		return $parts;
	}

	// Remove the placeholder values.
	foreach ( $to_unset as $key ) {
		unset( $parts[ $key ] );
	}

	return _get_component_from_parsed_url_array( $parts, $component );
}
```

## История изменений

- 4.7.0 — The $component parameter was added for parity with PHP’s parse_url().
- 4.4.0 — Introduced.

## Связанные

Использует: [`_get_component_from_parsed_url_array`](https://chugunov.pro/api-wordpress/functions/_get_component_from_parsed_url_array/).
Используется в: [`_load_script_textdomain_from_src`](https://chugunov.pro/api-wordpress/functions/_load_script_textdomain_from_src/), `WP_URL_Pattern_Prefixer::get_default_contexts`, [`wp_is_authorize_application_redirect_url_valid`](https://chugunov.pro/api-wordpress/functions/wp_is_authorize_application_redirect_url_valid/), [`_make_clickable_rel_attr`](https://chugunov.pro/api-wordpress/functions/_make_clickable_rel_attr/), [`make_clickable`](https://chugunov.pro/api-wordpress/functions/make_clickable/), [`wp_is_internal_link`](https://chugunov.pro/api-wordpress/functions/wp_is_internal_link/), [`wp_internal_hosts`](https://chugunov.pro/api-wordpress/functions/wp_internal_hosts/), [`wp_is_home_url_using_https`](https://chugunov.pro/api-wordpress/functions/wp_is_home_url_using_https/), [`wp_is_site_url_using_https`](https://chugunov.pro/api-wordpress/functions/wp_is_site_url_using_https/), [`wp_should_replace_insecure_home_url`](https://chugunov.pro/api-wordpress/functions/wp_should_replace_insecure_home_url/), `WP_REST_Server::serve_batch_request_v1`, [`get_oembed_response_data_for_url`](https://chugunov.pro/api-wordpress/functions/get_oembed_response_data_for_url/), `WP_Customize_Manager::is_cross_domain`, `WP_Customize_Manager::add_state_query_params`, [`wp_resource_hints`](https://chugunov.pro/api-wordpress/functions/wp_resource_hints/), [`wp_dependencies_unique_hosts`](https://chugunov.pro/api-wordpress/functions/wp_dependencies_unique_hosts/), [`strip_fragment_from_url`](https://chugunov.pro/api-wordpress/functions/strip_fragment_from_url/), `WP_Http::parse_url`, `WP_Customize_Manager::customize_preview_settings`, [`esc_url`](https://chugunov.pro/api-wordpress/functions/esc_url/), [`wp_notify_postauthor`](https://chugunov.pro/api-wordpress/functions/wp_notify_postauthor/), [`wp_mail`](https://chugunov.pro/api-wordpress/functions/wp_mail/), `WP_Http::make_absolute_url`, [`wp_update_plugins`](https://chugunov.pro/api-wordpress/functions/wp_update_plugins/), [`wp_update_themes`](https://chugunov.pro/api-wordpress/functions/wp_update_themes/), [`wp_video_shortcode`](https://chugunov.pro/api-wordpress/functions/wp_video_shortcode/), [`wpmu_welcome_user_notification`](https://chugunov.pro/api-wordpress/functions/wpmu_welcome_user_notification/), [`wpmu_welcome_notification`](https://chugunov.pro/api-wordpress/functions/wpmu_welcome_notification/), [`wpmu_signup_blog_notification`](https://chugunov.pro/api-wordpress/functions/wpmu_signup_blog_notification/), [`wpmu_signup_user_notification`](https://chugunov.pro/api-wordpress/functions/wpmu_signup_user_notification/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/wp_parse_url/