wp_image_src_get_dimensions( string $image_src, array $image_meta, int $attachment_id )

Determines an image’s width and height dimensions based on the source file.


Parameters Parameters

$image_src

(string) (Required) The image source file.

$image_meta

(array) (Required) The image meta data as returned by 'wp_get_attachment_metadata()'.

$attachment_id

(int) (Optional) The image attachment ID. Default 0.


Top ↑

Return Return

(array|false) Array with first element being the width and second element being the height, or false if dimensions cannot be determined.


Top ↑

Source Source

File: wp-includes/media.php

function wp_image_src_get_dimensions( $image_src, $image_meta, $attachment_id = 0 ) {
	if ( ! wp_image_file_matches_image_meta( $image_src, $image_meta, $attachment_id ) ) {
		return false;
	}

	// Is it a full size image?
	if ( strpos( $image_src, $image_meta['file'] ) !== false ) {
		return array(
			(int) $image_meta['width'],
			(int) $image_meta['height'],
		);
	}

	if ( ! empty( $image_meta['sizes'] ) ) {
		$src_filename = wp_basename( $image_src );

		foreach ( $image_meta['sizes'] as $image_size_data ) {
			if ( $src_filename === $image_size_data['file'] ) {
				return array(
					(int) $image_size_data['width'],
					(int) $image_size_data['height'],
				);
			}
		}
	}

	return false;
}


Top ↑

Changelog Changelog

Changelog
Version Description
5.5.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

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