# wp_parse_args()

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

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

## Сигнатура

```php
wp_parse_args( string|array|object $args, array $defaults = array() ): array
```

## Описание

Эта функция используется во всём WordPress, чтобы можно было объединять с другим массивом как строку, так и массив.

## Параметры

- `$args` `string|array|object` — обязательный. Значение для объединения с $defaults.
- `$defaults` `array` — необязательный, по умолчанию `array()`. Массив, служащий значениями по умолчанию.

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

`array`

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

Файл: `wp-includes/functions.php:4963`

```php
function wp_parse_args( $args, $defaults = array() ) {
	if ( is_object( $args ) ) {
		$parsed_args = get_object_vars( $args );
	} elseif ( is_array( $args ) ) {
		$parsed_args =& $args;
	} else {
		wp_parse_str( $args, $parsed_args );
	}

	if ( is_array( $defaults ) && $defaults ) {
		return array_merge( $defaults, $parsed_args );
	}
	return $parsed_args;
}
```

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

- 2.3.0 — $args can now also be an object.
- 2.2.0 — Introduced.

## Связанные

Использует: [`wp_parse_str`](https://chugunov.pro/api-wordpress/functions/wp_parse_str/).
Используется в: `WP_Debug_Data::get_wp_plugins_raw_data`, `WP_Ability::prepare_properties`, `WP_Block_Templates_Registry::get_by_query`, `WP_Font_Utils::get_font_face_slug`, `WP_Font_Collection::get_data`, [`wp_get_admin_notice`](https://chugunov.pro/api-wordpress/functions/wp_get_admin_notice/), `WP_Font_Face::validate_font_face_declarations`, [`_wp_build_title_and_description_for_single_post_type_block_template`](https://chugunov.pro/api-wordpress/functions/_wp_build_title_and_description_for_single_post_type_block_template/), [`_wp_build_title_and_description_for_taxonomy_block_template`](https://chugunov.pro/api-wordpress/functions/_wp_build_title_and_description_for_taxonomy_block_template/), `WP_Style_Engine_Processor::get_css`, [`wp_style_engine_get_styles`](https://chugunov.pro/api-wordpress/functions/wp_style_engine_get_styles/), [`wp_style_engine_get_stylesheet_from_css_rules`](https://chugunov.pro/api-wordpress/functions/wp_style_engine_get_stylesheet_from_css_rules/), [`_wp_theme_json_webfonts_handler`](https://chugunov.pro/api-wordpress/functions/_wp_theme_json_webfonts_handler/), [`wp_json_file_decode`](https://chugunov.pro/api-wordpress/functions/wp_json_file_decode/), [`wp_list_users`](https://chugunov.pro/api-wordpress/functions/wp_list_users/), [`wp_enqueue_block_style`](https://chugunov.pro/api-wordpress/functions/wp_enqueue_block_style/), `WP_Widget_Block::form`, `WP_Widget_Block::widget`, `WP_Theme_JSON_Resolver::get_theme_data`, `WP_REST_Templates_Controller::prepare_item_for_database`, `WP_REST_Comments_Controller::check_is_comment_content_allowed`, `WP_Block::render`, `WP_REST_Block_Types_Controller::prepare_item_for_response`, [`register_theme_feature`](https://chugunov.pro/api-wordpress/functions/register_theme_feature/), [`add_theme_support`](https://chugunov.pro/api-wordpress/functions/add_theme_support/), `WP_Embed::get_embed_handler_html`, [`wp_initialize_site`](https://chugunov.pro/api-wordpress/functions/wp_initialize_site/), [`wp_prepare_site_data`](https://chugunov.pro/api-wordpress/functions/wp_prepare_site_data/), [`_wp_die_process_input`](https://chugunov.pro/api-wordpress/functions/_wp_die_process_input/), [`wp_die`](https://chugunov.pro/api-wordpress/functions/wp_die/), [`populate_network_meta`](https://chugunov.pro/api-wordpress/functions/populate_network_meta/), [`get_oembed_response_data_for_url`](https://chugunov.pro/api-wordpress/functions/get_oembed_response_data_for_url/), `WP_Block_Type::set_props`, `WP_Widget_Custom_HTML::form`, [`get_term_parents_list`](https://chugunov.pro/api-wordpress/functions/get_term_parents_list/), `WP_oEmbed::get_data`, `WP_Widget_Media::form`, `WP_Widget_Media::widget`, `WP_Widget_Media_Image::render_media`, `WP_Widget_Media::__construct`.

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