# get_attachment_icon()

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

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

> Устаревший элемент. Помечен устаревшим с версии 2.5.0.

## Сигнатура

```php
get_attachment_icon( int $id, bool $fullsize = false, array $max_dims = false ): string|false
```

## Описание

См. alsowp_get_attachment_image()

## Параметры

- `$id` `int` — необязательный. Идентификатор записи.
- `$fullsize` `bool` — необязательный, по умолчанию `false`. Использовать ли изображение полного размера.
- `$max_dims` `array` — необязательный, по умолчанию `false`. Размеры изображения.

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

`string|false`

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

Файл: `wp-includes/deprecated.php:1942`

```php
function get_attachment_icon( $id = 0, $fullsize = false, $max_dims = false ) {
	_deprecated_function( __FUNCTION__, '2.5.0', 'wp_get_attachment_image()' );
	$id = (int) $id;
	if ( !$post = get_post($id) )
		return false;

	if ( !$src = get_attachment_icon_src( $post->ID, $fullsize ) )
		return false;

	list($src, $src_file) = $src;

	// Do we need to constrain the image?
	if ( ($max_dims = apply_filters('attachment_max_dims', $max_dims)) && file_exists($src_file) ) {

		$imagesize = wp_getimagesize($src_file);

		if (($imagesize[0] > $max_dims[0]) || $imagesize[1] > $max_dims[1] ) {
			$actual_aspect = $imagesize[0] / $imagesize[1];
			$desired_aspect = $max_dims[0] / $max_dims[1];

			if ( $actual_aspect >= $desired_aspect ) {
				$height = $actual_aspect * $max_dims[0];
				$constraint = "width='{$max_dims[0]}' ";
				$post->iconsize = array($max_dims[0], $height);
			} else {
				$width = $max_dims[1] / $actual_aspect;
				$constraint = "height='{$max_dims[1]}' ";
				$post->iconsize = array($width, $max_dims[1]);
			}
		} else {
			$post->iconsize = array($imagesize[0], $imagesize[1]);
			$constraint = '';
		}
	} else {
		$constraint = '';
	}

	$post_title = esc_attr($post->post_title);

	$icon = "<img src='$src' title='$post_title' alt='$post_title' $constraint/>";

	return apply_filters( 'attachment_icon', $icon, $post->ID );
}
```

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

- 2.5.0 — Deprecated. Use wp_get_attachment_image()
- 2.0.0 — Introduced.

## Связанные

Использует: [`wp_getimagesize`](https://chugunov.pro/api-wordpress/functions/wp_getimagesize/), [`get_attachment_icon_src`](https://chugunov.pro/api-wordpress/functions/get_attachment_icon_src/), [`esc_attr`](https://chugunov.pro/api-wordpress/functions/esc_attr/), [`_deprecated_function`](https://chugunov.pro/api-wordpress/functions/_deprecated_function/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/), [`get_post`](https://chugunov.pro/api-wordpress/functions/get_post/).
Используется в: [`get_attachment_innerHTML`](https://chugunov.pro/api-wordpress/functions/get_attachment_innerhtml/).

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