# wp_image_matches_ratio()

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

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

## Сигнатура

```php
wp_image_matches_ratio( int $source_width, int $source_height, int $target_width, int $target_height ): bool
```

## Описание

Вспомогательная функция для проверки совпадения соотношения сторон двух изображений.

## Параметры

- `$source_width` `int` — обязательный. Ширина первого изображения в пикселях.
- `$source_height` `int` — обязательный. Высота первого изображения в пикселях.
- `$target_width` `int` — обязательный. Ширина второго изображения в пикселях.
- `$target_height` `int` — обязательный. Высота второго изображения в пикселях.

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

`bool`

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

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

```php
function wp_image_matches_ratio( $source_width, $source_height, $target_width, $target_height ) {
	/*
	 * To test for varying crops, we constrain the dimensions of the larger image
	 * to the dimensions of the smaller image and see if they match.
	 */
	if ( $source_width > $target_width ) {
		$constrained_size = wp_constrain_dimensions( $source_width, $source_height, $target_width );
		$expected_size    = array( $target_width, $target_height );
	} else {
		$constrained_size = wp_constrain_dimensions( $target_width, $target_height, $source_width );
		$expected_size    = array( $source_width, $source_height );
	}

	// If the image dimensions are within 1px of the expected size, we consider it a match.
	$matched = ( wp_fuzzy_number_match( $constrained_size[0], $expected_size[0] ) && wp_fuzzy_number_match( $constrained_size[1], $expected_size[1] ) );

	return $matched;
}
```

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

- 4.6.0 — Introduced.

## Связанные

Использует: [`wp_fuzzy_number_match`](https://chugunov.pro/api-wordpress/functions/wp_fuzzy_number_match/), [`wp_constrain_dimensions`](https://chugunov.pro/api-wordpress/functions/wp_constrain_dimensions/).
Используется в: [`wp_calculate_image_srcset`](https://chugunov.pro/api-wordpress/functions/wp_calculate_image_srcset/), [`image_get_intermediate_size`](https://chugunov.pro/api-wordpress/functions/image_get_intermediate_size/).

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