wp_load_image() │ WP 2.1.0

Deprecated from version 3.5.0. It is no longer supported and can be removed in future releases. Use wp_get_image_editor() instead.

Load an image from a string, if PHP supports it.

No Hooks.

Return

resource|GdImage|String. The resulting image resource or GdImage instance on success, error string on failure.

Usage

wp_load_image( $file );

$file(string) (required): Filename of the image to load.

Notes

See: wp_get_image_editor()

Changelog

Since 2.1.0	Introduced.
Deprecated Since 3.5.0		Use wp_get_image_editor()

Code of `wp_load_image() wp load image` ^{WP 6.0}

wp-includes/deprecated.php

function wp_load_image( $file ) {
	_deprecated_function( __FUNCTION__, '3.5.0', 'wp_get_image_editor()' );

	if ( is_numeric( $file ) )
		$file = get_attached_file( $file );

	if ( ! is_file( $file ) ) {
		/* translators: %s: File name. */
		return sprintf( __( 'File &#8220;%s&#8221; does not exist?' ), $file );
	}

	if ( ! function_exists('imagecreatefromstring') )
		return __('The GD image library is not installed.');

	// Set artificially high because GD uses uncompressed images in memory.
	wp_raise_memory_limit( 'image' );

	$image = imagecreatefromstring( file_get_contents( $file ) );

	if ( ! is_gd_image( $image ) ) {
		/* translators: %s: File name. */
		return sprintf( __( 'File &#8220;%s&#8221; is not an image.' ), $file );
	}

	return $image;
}