Question

wp_get_image_editor( string $path,  array $args = array() )

Returns a WP_Image_Editor instance and loads file into it.

---

description

---

参数

$path

(string) (Required) Path to the file to load.

$args

(array) (Optional) Additional arguments for retrieving the image editor.

Default value: array()

---

返回值

(WP_Image_Editor|WP_Error) The WP_Image_Editor object if successful, an WP_Error object otherwise.

---

源代码

File: wp-includes/media.php

function wp_get_image_editor( $path, $args = array() ) {
	$args['path'] = $path;

	if ( ! isset( $args['mime_type'] ) ) {
		$file_info = wp_check_filetype( $args['path'] );

		// If $file_info['type'] is false, then we let the editor attempt to
		// figure out the file type, rather than forcing a failure based on extension.
		if ( isset( $file_info ) && $file_info['type'] )
			$args['mime_type'] = $file_info['type'];
	}

	$implementation = _wp_image_editor_choose( $args );

	if ( $implementation ) {
		$editor = new $implementation( $path );
		$loaded = $editor->load();

		if ( is_wp_error( $loaded ) )
			return $loaded;

		return $editor;
	}

	return new WP_Error( 'image_no_editor', __('No editor could be selected.') );
}

---

更新日志

Version	description
3.5.0	Introduced.

---

相关函数

Uses

• wp-includes/l10n.php: __()
• wp-includes/functions.php: wp_check_filetype()
• wp-includes/load.php: is_wp_error()
• wp-includes/class-wp-error.php: WP_Error::__construct()

---

Used By

• wp-admin/includes/image-edit.php: stream_preview_image()
• wp-admin/includes/image-edit.php: wp_save_image()
• wp-admin/includes/image.php: wp_generate_attachment_metadata()
• wp-admin/includes/image.php: wp_crop_image()
• wp-includes/deprecated.php: image_resize()
• wp-includes/media.php: image_make_intermediate_size()
Show 1 more used by Hide more used by

---

User Contributed Notes

1. Skip to note content You must log in to vote on the helpfulness of this noteVote results for this note: 4You must log in to vote on the helpfulness of this note Contributed by Codex

   Basic Example

   
   $image = wp_get_image_editor( 'cool_image.jpg' );
   if ( ! is_wp_error( $image ) ) {
       $image->rotate( 90 );
       $image->resize( 300, 300, true );
       $image->save( 'new_image.jpg' );
   }