# image_resize()

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

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

> Устаревший элемент. Помечен устаревшим с версии 3.5.0.

## Сигнатура

```php
image_resize( string $file, int $max_w, int $max_h, bool $crop = false, string $suffix = null, string $dest_path = null, int $jpeg_quality = 90 ): mixed
```

## Описание

Функция сохраняет прозрачность PNG, а также тип изображения. Если на входе файл PNG, то изменённое по размеру изображение тоже будет PNG. Поддерживаются только типы изображений PNG, GIF и JPEG.
Некоторые возможности требуют наличия соответствующего API, поэтому в некоторых версиях PHP поддержка может отсутствовать. Это не вина WordPress (где происходит понижение функциональности, а не реальные дефекты), а особенность вашей версии PHP.
См. alsowp_get_image_editor()

## Параметры

- `$file` `string` — обязательный. Путь к файлу изображения.
- `$max_w` `int` — обязательный. Максимальная ширина для изменения размера.
- `$max_h` `int` — обязательный. Максимальная высота для изменения размера.
- `$crop` `bool` — необязательный, по умолчанию `false`. Обрезать изображение или изменить его размер.
- `$suffix` `string` — необязательный, по умолчанию `null`. Суффикс файла.
- `$dest_path` `string` — необязательный, по умолчанию `null`. Путь к файлу нового изображения.
- `$jpeg_quality` `int` — необязательный, по умолчанию `90`. Качество изображения в процентах.

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

`mixed` — WP_Error

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

Файл: `wp-includes/deprecated.php:3253`

```php
function image_resize( $file, $max_w, $max_h, $crop = false, $suffix = null, $dest_path = null, $jpeg_quality = 90 ) {
	_deprecated_function( __FUNCTION__, '3.5.0', 'wp_get_image_editor()' );

	$editor = wp_get_image_editor( $file );
	if ( is_wp_error( $editor ) )
		return $editor;
	$editor->set_quality( $jpeg_quality );

	$resized = $editor->resize( $max_w, $max_h, $crop );
	if ( is_wp_error( $resized ) )
		return $resized;

	$dest_file = $editor->generate_filename( $suffix, $dest_path );
	$saved = $editor->save( $dest_file );

	if ( is_wp_error( $saved ) )
		return $saved;

	return $dest_file;
}
```

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

- 3.5.0 — Deprecated. Use wp_get_image_editor()
- 2.5.0 — Introduced.

## Связанные

Использует: [`wp_get_image_editor`](https://chugunov.pro/api-wordpress/functions/wp_get_image_editor/), [`WP_Image_Editor`](https://chugunov.pro/api-wordpress/functions/wp_image_editor/), [`_deprecated_function`](https://chugunov.pro/api-wordpress/functions/_deprecated_function/), [`is_wp_error`](https://chugunov.pro/api-wordpress/functions/is_wp_error/).
Используется в: [`wp_create_thumbnail`](https://chugunov.pro/api-wordpress/functions/wp_create_thumbnail/).

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