image_resize() │ WP 2.5.0

Scale down an image to fit a particular size and save a new copy of the image.

The PNG transparency will be preserved using the function, as well as the image type. If the file going in is PNG, then the resized image is going to be PNG. The only supported image types are PNG, GIF, and JPEG.

Some functionality requires API to exist, so some PHP version may lose out support. This is not the fault of WordPress (where functionality is downgraded, not actual defects), but of your PHP version.

Хуков нет.

Возвращает

Разное. WP_Error on failure. String with new destination path.

Использование

image_resize( $file, $max_w, $max_h, $crop, $suffix, $dest_path, $jpeg_quality );

$file(строка) (обязательный)

Image file path.

$max_w(int) (обязательный)

Maximum width to resize to.

$max_h(int) (обязательный)

Maximum height to resize to.

$crop(true|false)

Whether to crop image or resize.
По умолчанию: false

$suffix(строка)

File suffix.
По умолчанию: null

$dest_path(строка)

New image file path.
По умолчанию: null

$jpeg_quality(int)

Image quality percentage.
По умолчанию: 90

Заметки

• Смотрите: wp_get_image_editor()

Список изменений

Код image_resize() image resize ^{WP 6.5.2}

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;
}