wp_image_src_get_dimensions

函式
wp_image_src_get_dimensions ( $image_src, $image_meta, $attachment_id = 0 )
引數
  • (string) $image_src The image source file.
    Required:
  • (array) $image_meta The image meta data as returned by 'wp_get_attachment_metadata()'.
    Required:
  • (int) $attachment_id Optional. The image attachment ID. Default 0.
    Required:
返回值
  • (array|false) Array with first element being the width and second element being the height, or false if dimensions cannot be determined.
定義位置
相關方法
image_resize_dimensionswp_shrink_dimensionswp_image_add_srcset_and_sizeswp_get_audio_extensionswp_expand_dimensions
引入
5.5.0
棄用
-

wp_image_src_get_dimensions: 這個函式用來獲取一個影象檔案的寬度和高度尺寸。它接受一個引數,即影象檔案的路徑,並返回一個包含寬度和高度鍵及其各自數值的陣列。

根據原始檔確定圖片的寬度和高度尺寸。

function wp_image_src_get_dimensions( $image_src, $image_meta, $attachment_id = 0 ) {
	$dimensions = false;

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

	if ( ! $dimensions && ! 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'] ) {
				$dimensions = array(
					(int) $image_size_data['width'],
					(int) $image_size_data['height'],
				);

				break;
			}
		}
	}

	/**
	 * Filters the 'wp_image_src_get_dimensions' value.
	 *
	 * @since 5.7.0
	 *
	 * @param array|false $dimensions    Array with first element being the width
	 *                                   and second element being the height, or
	 *                                   false if dimensions could not be determined.
	 * @param string      $image_src     The image source file.
	 * @param array       $image_meta    The image meta data as returned by
	 *                                   'wp_get_attachment_metadata()'.
	 * @param int         $attachment_id The image attachment ID. Default 0.
	 */
	return apply_filters( 'wp_image_src_get_dimensions', $dimensions, $image_src, $image_meta, $attachment_id );
}

常見問題

FAQs
檢視更多 >