# stream_preview_image()

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

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

## Сигнатура

```php
stream_preview_image( int $post_id ): bool
```

## Описание

Передаёт изображение записи в браузер вместе с изменениями, поставленными в очередь в `$_REQUEST[‘history’]`.

## Параметры

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

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

`bool`

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

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

```php
function stream_preview_image( $post_id ) {
	$post = get_post( $post_id );

	wp_raise_memory_limit( 'admin' );

	$img = wp_get_image_editor( _load_image_to_edit_path( $post_id ) );

	if ( is_wp_error( $img ) ) {
		return false;
	}

	$changes = ! empty( $_REQUEST['history'] ) ? json_decode( wp_unslash( $_REQUEST['history'] ) ) : null;
	if ( $changes ) {
		$img = image_edit_apply_changes( $img, $changes );
	}

	// Scale the image.
	$size = $img->get_size();
	$w    = $size['width'];
	$h    = $size['height'];

	$ratio = _image_get_preview_ratio( $w, $h );
	$w2    = max( 1, $w * $ratio );
	$h2    = max( 1, $h * $ratio );

	if ( is_wp_error( $img->resize( $w2, $h2 ) ) ) {
		return false;
	}

	return wp_stream_image( $img, $post->post_mime_type, $post_id );
}
```

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

- 2.9.0 — Introduced.

## Связанные

Использует: [`wp_raise_memory_limit`](https://chugunov.pro/api-wordpress/functions/wp_raise_memory_limit/), [`image_edit_apply_changes`](https://chugunov.pro/api-wordpress/functions/image_edit_apply_changes/), [`wp_stream_image`](https://chugunov.pro/api-wordpress/functions/wp_stream_image/), [`WP_Image_Editor`](https://chugunov.pro/api-wordpress/functions/wp_image_editor/), [`_load_image_to_edit_path`](https://chugunov.pro/api-wordpress/functions/_load_image_to_edit_path/), [`wp_get_image_editor`](https://chugunov.pro/api-wordpress/functions/wp_get_image_editor/), [`wp_unslash`](https://chugunov.pro/api-wordpress/functions/wp_unslash/), [`get_post`](https://chugunov.pro/api-wordpress/functions/get_post/), [`is_wp_error`](https://chugunov.pro/api-wordpress/functions/is_wp_error/).
Используется в: [`wp_ajax_imgedit_preview`](https://chugunov.pro/api-wordpress/functions/wp_ajax_imgedit_preview/).

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