# wp_update_image_subsizes()

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

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

## Сигнатура

```php
wp_update_image_subsizes( int $attachment_id ): array|WP_Error
```

## Описание

Если какие-либо из текущих зарегистрированных подразмеров изображения отсутствуют, создаёт их и обновляет метаданные изображения.

## Параметры

- `$attachment_id` `int` — обязательный. ID записи-вложения изображения.

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

`array|WP_Error` — WP_Error

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

Файл: `wp-admin/includes/image.php:159`

```php
function wp_update_image_subsizes( $attachment_id ) {
	$image_meta = wp_get_attachment_metadata( $attachment_id );
	$image_file = wp_get_original_image_path( $attachment_id );

	if ( empty( $image_meta ) || ! is_array( $image_meta ) ) {
		/*
		 * Previously failed upload?
		 * If there is an uploaded file, make all sub-sizes and generate all of the attachment meta.
		 */
		if ( ! empty( $image_file ) ) {
			$image_meta = wp_create_image_subsizes( $image_file, $attachment_id );
		} else {
			return new WP_Error( 'invalid_attachment', __( 'The attached file cannot be found.' ) );
		}
	} else {
		$missing_sizes = wp_get_missing_image_subsizes( $attachment_id );

		if ( empty( $missing_sizes ) ) {
			return $image_meta;
		}

		// This also updates the image meta.
		$image_meta = _wp_make_subsizes( $missing_sizes, $image_file, $image_meta, $attachment_id );
	}

	/** This filter is documented in wp-admin/includes/image.php */
	$image_meta = apply_filters( 'wp_generate_attachment_metadata', $image_meta, $attachment_id, 'update' );

	// Save the updated metadata.
	wp_update_attachment_metadata( $attachment_id, $image_meta );

	return $image_meta;
}
```

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

- 5.3.0 — Introduced.

## Связанные

Использует: [`wp_get_original_image_path`](https://chugunov.pro/api-wordpress/functions/wp_get_original_image_path/), [`wp_create_image_subsizes`](https://chugunov.pro/api-wordpress/functions/wp_create_image_subsizes/), [`wp_get_missing_image_subsizes`](https://chugunov.pro/api-wordpress/functions/wp_get_missing_image_subsizes/), [`_wp_make_subsizes`](https://chugunov.pro/api-wordpress/functions/_wp_make_subsizes/), [`wp_get_attachment_metadata`](https://chugunov.pro/api-wordpress/functions/wp_get_attachment_metadata/), [`wp_update_attachment_metadata`](https://chugunov.pro/api-wordpress/functions/wp_update_attachment_metadata/), [`__`](https://chugunov.pro/api-wordpress/functions/__/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/), `WP_Error::__construct`.
Используется в: `WP_REST_Attachments_Controller::post_process_item`, [`wp_ajax_media_create_image_subsizes`](https://chugunov.pro/api-wordpress/functions/wp_ajax_media_create_image_subsizes/).

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