WordPress Developer Resources

WP_Image_Editor::save( string $destfilename = null, string $mime_type = null ): array|WP_Error

Saves current image to file.

Parameters

$destfilenamestringoptional: Destination filename.
Default:null
$mime_typestringoptional: The mime-type.
Default:null

Return

array|WP_Error Array on success or WP_Error if the file failed to save.

path string
Path to the image file.
file string
Name of the image file.
width int
Image width.
height int
Image height.
mime-type string
The mime type of the image.
filesize int
File size of the image.

Source

abstract public function save( $destfilename = null, $mime_type = null );

View all references View on Trac View on GitHub

Changelog

Version	Description
6.0.0	The `$filesize` value was added to the returned array.
3.5.0	Introduced.

User Contributed Notes

Skip to note 2 content

thomasmathys 2 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Uppercase extension

Due to the presence of a strtolower in WP_Image_Editor::generate_filename, there can be issues with uppercase file extensions on linux-like system.
```
$image = wp_get_image_editor( 'path/to/SOURCE.JPG' );
$image->save( 'path/to/TARGET.JPG' );

if ( file_exists ( 'path/to/TARGET.JPG' ) ) {
	echo 'This will NOT show';
}
	
if ( file_exists ( 'path/to/TARGET.jpg' ) ) {
	echo 'This WILL show';
}
```
Log in to add feedback

You must log in before being able to contribute a note or feedback.