функция
since 5.5.0
wp_image_src_get_dimensions()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
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
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. |

