# wp_image_src_get_dimensions()

URL: https://chugunov.pro/api-wordpress/functions/wp_image_src_get_dimensions/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 5.5.0.

## Сигнатура

```php
wp_image_src_get_dimensions( string $image_src, array $image_meta, int $attachment_id ): array|false
```

## Описание

Определяет ширину и высоту изображения на основе исходного файла.

## Параметры

- `$image_src` `string` — обязательный. Исходный файл изображения.
- `$image_meta` `array` — обязательный. Метаданные изображения в том виде, в каком их возвращает 'wp_get_attachment_metadata() '.
- `$attachment_id` `int` — необязательный. ID вложения-изображения. Значение по умолчанию — 0.

## Возвращаемое значение

`array|false`

## Исходный код

Файл: `wp-includes/media.php:1715`

```php
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'] ) &&
		str_contains( $image_src, wp_basename( $image_meta['file'] ) )
	) {
		$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 );
}
```

## История изменений

- 5.5.0 — Introduced.

## Связанные

Использует: [`wp_basename`](https://chugunov.pro/api-wordpress/functions/wp_basename/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/).
Используется в: [`wp_img_tag_add_width_and_height_attr`](https://chugunov.pro/api-wordpress/functions/wp_img_tag_add_width_and_height_attr/), [`wp_image_add_srcset_and_sizes`](https://chugunov.pro/api-wordpress/functions/wp_image_add_srcset_and_sizes/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/wp_image_src_get_dimensions/