# wp_get_attachment_metadata()

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

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

## Сигнатура

```php
wp_get_attachment_metadata( int $attachment_id, bool $unfiltered = false ): array|false
```

## Описание

Возвращает метаданные вложения по его ID.

## Параметры

- `$attachment_id` `int` — обязательный. ID записи вложения. По умолчанию — глобальный $post.
- `$unfiltered` `bool` — необязательный, по умолчанию `false`. Если true, фильтры не выполняются.

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

`array|false` — width intШирина вложения. height intВысота вложения. file stringПуть к файлу относительно wp-content/uploads. sizes arrayКлючи — слаги размеров, каждое значение — массив, содержащий 'file', 'width', 'height' и 'mime-type'. image_meta arrayМетаданные изображения. filesize intРазмер файла вложения.

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

Файл: `wp-includes/post.php:6889`

```php
function wp_get_attachment_metadata( $attachment_id = 0, $unfiltered = false ) {
	$attachment_id = (int) $attachment_id;

	if ( ! $attachment_id ) {
		$post = get_post();

		if ( ! $post ) {
			return false;
		}

		$attachment_id = $post->ID;
	}

	$data = get_post_meta( $attachment_id, '_wp_attachment_metadata', true );

	if ( ! $data ) {
		return false;
	}

	if ( $unfiltered ) {
		return $data;
	}

	/**
	 * Filters the attachment meta data.
	 *
	 * @since 2.1.0
	 *
	 * @param array $data          Array of meta data for the given attachment.
	 * @param int   $attachment_id Attachment post ID.
	 */
	return apply_filters( 'wp_get_attachment_metadata', $data, $attachment_id );
}
```

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

- 6.0.0 — The $filesize value was added to the returned array.
- 2.1.0 — Introduced.

## Связанные

Использует: [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/), [`get_post_meta`](https://chugunov.pro/api-wordpress/functions/get_post_meta/), [`get_post`](https://chugunov.pro/api-wordpress/functions/get_post/).
Используется в: `WP_REST_Attachments_Controller::get_attachment_filesize`, `WP_REST_Attachments_Controller::edit_media_item`, [`wp_img_tag_add_width_and_height_attr`](https://chugunov.pro/api-wordpress/functions/wp_img_tag_add_width_and_height_attr/), [`wp_img_tag_add_srcset_and_sizes_attr`](https://chugunov.pro/api-wordpress/functions/wp_img_tag_add_srcset_and_sizes_attr/), [`wp_get_original_image_path`](https://chugunov.pro/api-wordpress/functions/wp_get_original_image_path/), [`wp_get_original_image_url`](https://chugunov.pro/api-wordpress/functions/wp_get_original_image_url/), [`wp_get_missing_image_subsizes`](https://chugunov.pro/api-wordpress/functions/wp_get_missing_image_subsizes/), [`wp_update_image_subsizes`](https://chugunov.pro/api-wordpress/functions/wp_update_image_subsizes/), `WP_Widget_Media_Image::render_media`, `WP_Customize_Manager::import_theme_starter_content`, `WP_REST_Attachments_Controller::prepare_item_for_response`, [`wp_get_attachment_image_srcset`](https://chugunov.pro/api-wordpress/functions/wp_get_attachment_image_srcset/), [`wp_get_attachment_image_sizes`](https://chugunov.pro/api-wordpress/functions/wp_get_attachment_image_sizes/), [`wp_calculate_image_sizes`](https://chugunov.pro/api-wordpress/functions/wp_calculate_image_sizes/), [`wp_restore_image`](https://chugunov.pro/api-wordpress/functions/wp_restore_image/), [`wp_save_image`](https://chugunov.pro/api-wordpress/functions/wp_save_image/), [`wp_image_editor`](https://chugunov.pro/api-wordpress/functions/wp_image_editor/), [`edit_form_image_editor`](https://chugunov.pro/api-wordpress/functions/edit_form_image_editor/), [`attachment_submitbox_metadata`](https://chugunov.pro/api-wordpress/functions/attachment_submitbox_metadata/), [`get_media_item`](https://chugunov.pro/api-wordpress/functions/get_media_item/), [`edit_post`](https://chugunov.pro/api-wordpress/functions/edit_post/), [`wp_ajax_save_attachment`](https://chugunov.pro/api-wordpress/functions/wp_ajax_save_attachment/), [`attachment_id3_data_meta_box`](https://chugunov.pro/api-wordpress/functions/attachment_id3_data_meta_box/), `Custom_Image_Header::step_2`, [`get_uploaded_header_images`](https://chugunov.pro/api-wordpress/functions/get_uploaded_header_images/), [`prepend_attachment`](https://chugunov.pro/api-wordpress/functions/prepend_attachment/), [`wp_maybe_generate_attachment_metadata`](https://chugunov.pro/api-wordpress/functions/wp_maybe_generate_attachment_metadata/), [`wp_prepare_attachment_for_js`](https://chugunov.pro/api-wordpress/functions/wp_prepare_attachment_for_js/), [`gallery_shortcode`](https://chugunov.pro/api-wordpress/functions/gallery_shortcode/), [`wp_playlist_shortcode`](https://chugunov.pro/api-wordpress/functions/wp_playlist_shortcode/), [`image_get_intermediate_size`](https://chugunov.pro/api-wordpress/functions/image_get_intermediate_size/), [`wp_get_attachment_image`](https://chugunov.pro/api-wordpress/functions/wp_get_attachment_image/), [`image_downsize`](https://chugunov.pro/api-wordpress/functions/image_downsize/), [`wp_get_attachment_thumb_file`](https://chugunov.pro/api-wordpress/functions/wp_get_attachment_thumb_file/), [`wp_delete_attachment`](https://chugunov.pro/api-wordpress/functions/wp_delete_attachment/), `wp_xmlrpc_server::_prepare_media_item`.

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