函数原型
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
函数描述
Scale down an image to fit a particular size and save a new copy of the image.
是否弃用
Warning: This function has been deprecated. Use wp_get_image_editor() instead.
函数参数
-
$file
string
Required - Image file path.
-
$max_w
int
Required - Maximum width to resize to.
-
$max_h
int
Required - Maximum height to resize to.
-
$crop
bool
Optional - Whether to crop image or resize.
Default:
false -
$suffix
string
Optional - File suffix.
Default:
null -
$dest_path
string
Optional - New image file path.
Default:
null -
$jpeg_quality
int
Optional - Image quality percentage.
Default:
90
函数返回值
mixed WP_Error on failure. String with new destination path.
函数位置
File: wp-includes/deprecated.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;
}
源码链接
变更日志
| Version | Description |
|---|---|
| 3.5.0 | Use wp_get_image_editor() |
| 2.5.0 | Introduced. |

