# wp_get_attachment_image_src()

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

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

## Сигнатура

```php
wp_get_attachment_image_src( int $attachment_id, string|int[] $size = 'thumbnail', bool $icon = false ): array|false
```

## Описание

Получает изображение, представляющее вложение.

## Параметры

- `$attachment_id` `int` — обязательный. Идентификатор вложения-изображения.
- `$size` `string|int[]` — необязательный, по умолчанию `'thumbnail'`. Размер изображения. Принимает имя любого зарегистрированного размера изображения или массив значений ширины и высоты в пикселях (именно в таком порядке). Значение по умолчанию 'thumbnail'.
- `$icon` `bool` — необязательный, по умолчанию `false`. Использовать ли значок типа MIME в качестве запасного варианта для изображения.

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

`array|false` — 0 stringURL источника изображения. 1 intШирина изображения в пикселях. 2 intВысота изображения в пикселях. 3 boolЯвляется ли изображение изменённым по размеру.

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

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

```php
function wp_get_attachment_image_src( $attachment_id, $size = 'thumbnail', $icon = false ) {
	// Get a thumbnail or intermediate image if there is one.
	$image = image_downsize( $attachment_id, $size );
	if ( ! $image ) {
		$src = false;

		if ( $icon ) {
			$src = wp_mime_type_icon( $attachment_id, '.svg' );

			if ( $src ) {
				/** This filter is documented in wp-includes/post.php */
				$icon_dir = apply_filters( 'icon_dir', ABSPATH . WPINC . '/images/media' );

				$src_file = $icon_dir . '/' . wp_basename( $src );

				list( $width, $height ) = wp_getimagesize( $src_file );

				$ext = strtolower( substr( $src_file, -4 ) );

				if ( '.svg' === $ext ) {
					// SVG does not have true dimensions, so this assigns width and height directly.
					$width  = 48;
					$height = 64;
				} else {
					list( $width, $height ) = wp_getimagesize( $src_file );
				}
			}
		}

		if ( $src && $width && $height ) {
			$image = array( $src, $width, $height, false );
		}
	}
	/**
	 * Filters the attachment image source result.
	 *
	 * @since 4.3.0
	 *
	 * @param array|false  $image         {
	 *     Array of image data, or boolean false if no image is available.
	 *
	 *     @type string $0 Image source URL.
	 *     @type int    $1 Image width in pixels.
	 *     @type int    $2 Image height in pixels.
	 *     @type bool   $3 Whether the image is a resized image.
	 * }
	 * @param int          $attachment_id Image attachment ID.
	 * @param string|int[] $size          Requested image size. Can be any registered image size name, or
	 *                                    an array of width and height values in pixels (in that order).
	 * @param bool         $icon          Whether the image should be treated as an icon.
	 */
	return apply_filters( 'wp_get_attachment_image_src', $image, $attachment_id, $size, $icon );
}
```

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

- 2.5.0 — Introduced.

## Связанные

Использует: [`wp_getimagesize`](https://chugunov.pro/api-wordpress/functions/wp_getimagesize/), [`image_downsize`](https://chugunov.pro/api-wordpress/functions/image_downsize/), [`wp_mime_type_icon`](https://chugunov.pro/api-wordpress/functions/wp_mime_type_icon/), [`wp_basename`](https://chugunov.pro/api-wordpress/functions/wp_basename/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/).
Используется в: `WP_REST_Attachments_Controller::prepare_item_for_response`, [`get_oembed_response_data_rich`](https://chugunov.pro/api-wordpress/functions/get_oembed_response_data_rich/), [`wp_get_attachment_image_srcset`](https://chugunov.pro/api-wordpress/functions/wp_get_attachment_image_srcset/), [`wp_get_attachment_image_sizes`](https://chugunov.pro/api-wordpress/functions/wp_get_attachment_image_sizes/), [`wp_get_attachment_image_url`](https://chugunov.pro/api-wordpress/functions/wp_get_attachment_image_url/), [`wp_save_image`](https://chugunov.pro/api-wordpress/functions/wp_save_image/), [`edit_form_image_editor`](https://chugunov.pro/api-wordpress/functions/edit_form_image_editor/), [`get_media_item`](https://chugunov.pro/api-wordpress/functions/get_media_item/), `Custom_Image_Header::step_2`, `Custom_Background::wp_set_background_image`, `Custom_Background::handle_upload`, [`wp_prepare_attachment_for_js`](https://chugunov.pro/api-wordpress/functions/wp_prepare_attachment_for_js/), [`wp_playlist_shortcode`](https://chugunov.pro/api-wordpress/functions/wp_playlist_shortcode/), [`wp_get_attachment_image`](https://chugunov.pro/api-wordpress/functions/wp_get_attachment_image/).

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