W3cubDocs

/WordPress

WP_Image_Editor_Imagick::write_image( Imagick $image, string $filename ): true|WP_Error

Writes an image to a file or stream.

Parameters

$imageImagickrequired
$filenamestringrequired
The destination filename or stream URL.

Return

true|WP_Error

Source

private function write_image( $image, $filename ) {
	if ( wp_is_stream( $filename ) ) {
		/*
		 * Due to reports of issues with streams with `Imagick::writeImageFile()` and `Imagick::writeImage()`, copies the blob instead.
		 * Checks for exact type due to: https://www.php.net/manual/en/function.file-put-contents.php
		 */
		if ( file_put_contents( $filename, $image->getImageBlob() ) === false ) {
			return new WP_Error(
				'image_save_error',
				sprintf(
					/* translators: %s: PHP function name. */
					__( '%s failed while writing image to stream.' ),
					'<code>file_put_contents()</code>'
				),
				$filename
			);
		} else {
			return true;
		}
	} else {
		$dirname = dirname( $filename );

		if ( ! wp_mkdir_p( $dirname ) ) {
			return new WP_Error(
				'image_save_error',
				sprintf(
					/* translators: %s: Directory path. */
					__( 'Unable to create directory %s. Is its parent directory writable by the server?' ),
					esc_html( $dirname )
				)
			);
		}

		try {
			return $image->writeImage( $filename );
		} catch ( Exception $e ) {
			return new WP_Error( 'image_save_error', $e->getMessage(), $filename );
		}
	}
}

Changelog

Version Description
5.6.0 Introduced.

© 2003–2024 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_image_editor_imagick/write_image